libio/stdio.h

   1 /* Define ISO C stdio on top of C++ iostreams.
   2    Copyright (C) 1991-2017 Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, see
  17    <http://www.gnu.org/licenses/>.  */
  18
  19 /*
  20  *      ISO C99 Standard: 7.19 Input/output     <stdio.h>
  21  */
  22
  23 #ifndef _STDIO_H
  24 #define _STDIO_H        1
  25
  26 #define __GLIBC_INTERNAL_STARTING_HEADER_IMPLEMENTATION
  27 #include <bits/libc-header-start.h>
  28
  29 __BEGIN_DECLS
  30
  31 #define __need_size_t
  32 #define __need_NULL
  33 #include <stddef.h>
  34
  35 #include <bits/types.h>
  36 #include <bits/types/__FILE.h>
  37 #include <bits/types/FILE.h>
  38
  39 #define _STDIO_USES_IOSTREAM
  40
  41 #include <libio.h>
  42
  43 #if defined __USE_XOPEN || defined __USE_XOPEN2K8
  44 # ifdef __GNUC__
  45 #  ifndef _VA_LIST_DEFINED
  46 typedef _G_va_list va_list;
  47 #   define _VA_LIST_DEFINED
  48 #  endif
  49 # else
  50 #  include <stdarg.h>
  51 # endif
  52 #endif
  53
  54 #if defined __USE_UNIX98 || defined __USE_XOPEN2K
  55 # ifndef __off_t_defined
  56 # ifndef __USE_FILE_OFFSET64
  57 typedef __off_t off_t;
  58 # else
  59 typedef __off64_t off_t;
  60 # endif
  61 # define __off_t_defined
  62 # endif
  63 # if defined __USE_LARGEFILE64 && !defined __off64_t_defined
  64 typedef __off64_t off64_t;
  65 # define __off64_t_defined
  66 # endif
  67 #endif
  68
  69 #ifdef __USE_XOPEN2K8
  70 # ifndef __ssize_t_defined
  71 typedef __ssize_t ssize_t;
  72 # define __ssize_t_defined
  73 # endif
  74 #endif
  75
  76 /* The type of the second argument to `fgetpos' and `fsetpos'.  */
  77 #ifndef __USE_FILE_OFFSET64
  78 typedef _G_fpos_t fpos_t;
  79 #else
  80 typedef _G_fpos64_t fpos_t;
  81 #endif
  82 #ifdef __USE_LARGEFILE64
  83 typedef _G_fpos64_t fpos64_t;
  84 #endif
  85
  86 /* The possibilities for the third argument to `setvbuf'.  */
  87 #define _IOFBF 0                /* Fully buffered.  */
  88 #define _IOLBF 1                /* Line buffered.  */
  89 #define _IONBF 2                /* No buffering.  */
  90
  91
  92 /* Default buffer size.  */
  93 #ifndef BUFSIZ
  94 # define BUFSIZ _IO_BUFSIZ
  95 #endif
  96
  97
  98 /* End of file character.
  99    Some things throughout the library rely on this being -1.  */
 100 #ifndef EOF
 101 # define EOF (-1)
 102 #endif
 103
 104
 105 /* The possibilities for the third argument to `fseek'.
 106    These values should not be changed.  */
 107 #define SEEK_SET        0       /* Seek from beginning of file.  */
 108 #define SEEK_CUR        1       /* Seek from current position.  */
 109 #define SEEK_END        2       /* Seek from end of file.  */
 110 #ifdef __USE_GNU
 111 # define SEEK_DATA      3       /* Seek to next data.  */
 112 # define SEEK_HOLE      4       /* Seek to next hole.  */
 113 #endif
 114
 115
 116 #if defined __USE_MISC || defined __USE_XOPEN
 117 /* Default path prefix for `tempnam' and `tmpnam'.  */
 118 # define P_tmpdir       "/tmp"
 119 #endif
 120
 121
 122 /* Get the values:
 123    L_tmpnam     How long an array of chars must be to be passed to `tmpnam'.
 124    TMP_MAX      The minimum number of unique filenames generated by tmpnam
 125                 (and tempnam when it uses tmpnam's name space),
 126                 or tempnam (the two are separate).
 127    L_ctermid    How long an array to pass to `ctermid'.
 128    L_cuserid    How long an array to pass to `cuserid'.
 129    FOPEN_MAX    Minimum number of files that can be open at once.
 130    FILENAME_MAX Maximum length of a filename.  */
 131 #include <bits/stdio_lim.h>
 132
 133
 134 /* Standard streams.  */
 135 extern struct _IO_FILE *stdin;          /* Standard input stream.  */
 136 extern struct _IO_FILE *stdout;         /* Standard output stream.  */
 137 extern struct _IO_FILE *stderr;         /* Standard error output stream.  */
 138 /* C89/C99 say they're macros.  Make them happy.  */
 139 #define stdin stdin
 140 #define stdout stdout
 141 #define stderr stderr
 142
 143 /* Remove file FILENAME.  */
 144 extern int remove (const char *__filename) __THROW;
 145 /* Rename file OLD to NEW.  */
 146 extern int rename (const char *__old, const char *__new) __THROW;
 147
 148 #ifdef __USE_ATFILE
 149 /* Rename file OLD relative to OLDFD to NEW relative to NEWFD.  */
 150 extern int renameat (int __oldfd, const char *__old, int __newfd,
 151                      const char *__new) __THROW;
 152 #endif
 153
 154 /* Create a temporary file and open it read/write.
 155
 156    This function is a possible cancellation point and therefore not
 157    marked with __THROW.  */
 158 #ifndef __USE_FILE_OFFSET64
 159 extern FILE *tmpfile (void) __wur;
 160 #else
 161 # ifdef __REDIRECT
 162 extern FILE *__REDIRECT (tmpfile, (void), tmpfile64) __wur;
 163 # else
 164 #  define tmpfile tmpfile64
 165 # endif
 166 #endif
 167
 168 #ifdef __USE_LARGEFILE64
 169 extern FILE *tmpfile64 (void) __wur;
 170 #endif
 171
 172 /* Generate a temporary filename.  */
 173 extern char *tmpnam (char *__s) __THROW __wur;
 174
 175 #ifdef __USE_MISC
 176 /* This is the reentrant variant of `tmpnam'.  The only difference is
 177    that it does not allow S to be NULL.  */
 178 extern char *tmpnam_r (char *__s) __THROW __wur;
 179 #endif
 180
 181
 182 #if defined __USE_MISC || defined __USE_XOPEN
 183 /* Generate a unique temporary filename using up to five characters of PFX
 184    if it is not NULL.  The directory to put this file in is searched for
 185    as follows: First the environment variable "TMPDIR" is checked.
 186    If it contains the name of a writable directory, that directory is used.
 187    If not and if DIR is not NULL, that value is checked.  If that fails,
 188    P_tmpdir is tried and finally "/tmp".  The storage for the filename
 189    is allocated by `malloc'.  */
 190 extern char *tempnam (const char *__dir, const char *__pfx)
 191      __THROW __attribute_malloc__ __wur;
 192 #endif
 193
 194
 195 /* Close STREAM.
 196
 197    This function is a possible cancellation point and therefore not
 198    marked with __THROW.  */
 199 extern int fclose (FILE *__stream);
 200 /* Flush STREAM, or all streams if STREAM is NULL.
 201
 202    This function is a possible cancellation point and therefore not
 203    marked with __THROW.  */
 204 extern int fflush (FILE *__stream);
 205
 206 #ifdef __USE_MISC
 207 /* Faster versions when locking is not required.
 208
 209    This function is not part of POSIX and therefore no official
 210    cancellation point.  But due to similarity with an POSIX interface
 211    or due to the implementation it is a cancellation point and
 212    therefore not marked with __THROW.  */
 213 extern int fflush_unlocked (FILE *__stream);
 214 #endif
 215
 216 #ifdef __USE_GNU
 217 /* Close all streams.
 218
 219    This function is not part of POSIX and therefore no official
 220    cancellation point.  But due to similarity with an POSIX interface
 221    or due to the implementation it is a cancellation point and
 222    therefore not marked with __THROW.  */
 223 extern int fcloseall (void);
 224 #endif
 225
 226
 227 #ifndef __USE_FILE_OFFSET64
 228 /* Open a file and create a new stream for it.
 229
 230    This function is a possible cancellation point and therefore not
 231    marked with __THROW.  */
 232 extern FILE *fopen (const char *__restrict __filename,
 233                     const char *__restrict __modes) __wur;
 234 /* Open a file, replacing an existing stream with it.
 235
 236    This function is a possible cancellation point and therefore not
 237    marked with __THROW.  */
 238 extern FILE *freopen (const char *__restrict __filename,
 239                       const char *__restrict __modes,
 240                       FILE *__restrict __stream) __wur;
 241 #else
 242 # ifdef __REDIRECT
 243 extern FILE *__REDIRECT (fopen, (const char *__restrict __filename,
 244                                  const char *__restrict __modes), fopen64)
 245   __wur;
 246 extern FILE *__REDIRECT (freopen, (const char *__restrict __filename,
 247                                    const char *__restrict __modes,
 248                                    FILE *__restrict __stream), freopen64)
 249   __wur;
 250 # else
 251 #  define fopen fopen64
 252 #  define freopen freopen64
 253 # endif
 254 #endif
 255 #ifdef __USE_LARGEFILE64
 256 extern FILE *fopen64 (const char *__restrict __filename,
 257                       const char *__restrict __modes) __wur;
 258 extern FILE *freopen64 (const char *__restrict __filename,
 259                         const char *__restrict __modes,
 260                         FILE *__restrict __stream) __wur;
 261 #endif
 262
 263 #ifdef  __USE_POSIX
 264 /* Create a new stream that refers to an existing system file descriptor.  */
 265 extern FILE *fdopen (int __fd, const char *__modes) __THROW __wur;
 266 #endif
 267
 268 #ifdef  __USE_GNU
 269 /* Create a new stream that refers to the given magic cookie,
 270    and uses the given functions for input and output.  */
 271 extern FILE *fopencookie (void *__restrict __magic_cookie,
 272                           const char *__restrict __modes,
 273                           _IO_cookie_io_functions_t __io_funcs) __THROW __wur;
 274 #endif
 275
 276 #if defined __USE_XOPEN2K8 || __GLIBC_USE (LIB_EXT2)
 277 /* Create a new stream that refers to a memory buffer.  */
 278 extern FILE *fmemopen (void *__s, size_t __len, const char *__modes)
 279   __THROW __wur;
 280
 281 /* Open a stream that writes into a malloc'd buffer that is expanded as
 282    necessary.  *BUFLOC and *SIZELOC are updated with the buffer's location
 283    and the number of characters written on fflush or fclose.  */
 284 extern FILE *open_memstream (char **__bufloc, size_t *__sizeloc) __THROW __wur;
 285 #endif
 286
 287
 288 /* If BUF is NULL, make STREAM unbuffered.
 289    Else make it use buffer BUF, of size BUFSIZ.  */
 290 extern void setbuf (FILE *__restrict __stream, char *__restrict __buf) __THROW;
 291 /* Make STREAM use buffering mode MODE.
 292    If BUF is not NULL, use N bytes of it for buffering;
 293    else allocate an internal buffer N bytes long.  */
 294 extern int setvbuf (FILE *__restrict __stream, char *__restrict __buf,
 295                     int __modes, size_t __n) __THROW;
 296
 297 #ifdef  __USE_MISC
 298 /* If BUF is NULL, make STREAM unbuffered.
 299    Else make it use SIZE bytes of BUF for buffering.  */
 300 extern void setbuffer (FILE *__restrict __stream, char *__restrict __buf,
 301                        size_t __size) __THROW;
 302
 303 /* Make STREAM line-buffered.  */
 304 extern void setlinebuf (FILE *__stream) __THROW;
 305 #endif
 306
 307
 308 /* Write formatted output to STREAM.
 309
 310    This function is a possible cancellation point and therefore not
 311    marked with __THROW.  */
 312 extern int fprintf (FILE *__restrict __stream,
 313                     const char *__restrict __format, ...);
 314 /* Write formatted output to stdout.
 315
 316    This function is a possible cancellation point and therefore not
 317    marked with __THROW.  */
 318 extern int printf (const char *__restrict __format, ...);
 319 /* Write formatted output to S.  */
 320 extern int sprintf (char *__restrict __s,
 321                     const char *__restrict __format, ...) __THROWNL;
 322
 323 /* Write formatted output to S from argument list ARG.
 324
 325    This function is a possible cancellation point and therefore not
 326    marked with __THROW.  */
 327 extern int vfprintf (FILE *__restrict __s, const char *__restrict __format,
 328                      _G_va_list __arg);
 329 /* Write formatted output to stdout from argument list ARG.
 330
 331    This function is a possible cancellation point and therefore not
 332    marked with __THROW.  */
 333 extern int vprintf (const char *__restrict __format, _G_va_list __arg);
 334 /* Write formatted output to S from argument list ARG.  */
 335 extern int vsprintf (char *__restrict __s, const char *__restrict __format,
 336                      _G_va_list __arg) __THROWNL;
 337
 338 #if defined __USE_ISOC99 || defined __USE_UNIX98
 339 /* Maximum chars of output to write in MAXLEN.  */
 340 extern int snprintf (char *__restrict __s, size_t __maxlen,
 341                      const char *__restrict __format, ...)
 342      __THROWNL __attribute__ ((__format__ (__printf__, 3, 4)));
 343
 344 extern int vsnprintf (char *__restrict __s, size_t __maxlen,
 345                       const char *__restrict __format, _G_va_list __arg)
 346      __THROWNL __attribute__ ((__format__ (__printf__, 3, 0)));
 347 #endif
 348
 349 #if __GLIBC_USE (LIB_EXT2)
 350 /* Write formatted output to a string dynamically allocated with `malloc'.
 351    Store the address of the string in *PTR.  */
 352 extern int vasprintf (char **__restrict __ptr, const char *__restrict __f,
 353                       _G_va_list __arg)
 354      __THROWNL __attribute__ ((__format__ (__printf__, 2, 0))) __wur;
 355 extern int __asprintf (char **__restrict __ptr,
 356                        const char *__restrict __fmt, ...)
 357      __THROWNL __attribute__ ((__format__ (__printf__, 2, 3))) __wur;
 358 extern int asprintf (char **__restrict __ptr,
 359                      const char *__restrict __fmt, ...)
 360      __THROWNL __attribute__ ((__format__ (__printf__, 2, 3))) __wur;
 361 #endif
 362
 363 #ifdef __USE_XOPEN2K8
 364 /* Write formatted output to a file descriptor.  */
 365 extern int vdprintf (int __fd, const char *__restrict __fmt,
 366                      _G_va_list __arg)
 367      __attribute__ ((__format__ (__printf__, 2, 0)));
 368 extern int dprintf (int __fd, const char *__restrict __fmt, ...)
 369      __attribute__ ((__format__ (__printf__, 2, 3)));
 370 #endif
 371
 372
 373 /* Read formatted input from STREAM.
 374
 375    This function is a possible cancellation point and therefore not
 376    marked with __THROW.  */
 377 extern int fscanf (FILE *__restrict __stream,
 378                    const char *__restrict __format, ...) __wur;
 379 /* Read formatted input from stdin.
 380
 381    This function is a possible cancellation point and therefore not
 382    marked with __THROW.  */
 383 extern int scanf (const char *__restrict __format, ...) __wur;
 384 /* Read formatted input from S.  */
 385 extern int sscanf (const char *__restrict __s,
 386                    const char *__restrict __format, ...) __THROW;
 387
 388 #if defined __USE_ISOC99 && !defined __USE_GNU \
 389     && (!defined __LDBL_COMPAT || !defined __REDIRECT) \
 390     && (defined __STRICT_ANSI__ || defined __USE_XOPEN2K)
 391 # ifdef __REDIRECT
 392 /* For strict ISO C99 or POSIX compliance disallow %as, %aS and %a[
 393    GNU extension which conflicts with valid %a followed by letter
 394    s, S or [.  */
 395 extern int __REDIRECT (fscanf, (FILE *__restrict __stream,
 396                                 const char *__restrict __format, ...),
 397                        __isoc99_fscanf) __wur;
 398 extern int __REDIRECT (scanf, (const char *__restrict __format, ...),
 399                        __isoc99_scanf) __wur;
 400 extern int __REDIRECT_NTH (sscanf, (const char *__restrict __s,
 401                                     const char *__restrict __format, ...),
 402                            __isoc99_sscanf);
 403 # else
 404 extern int __isoc99_fscanf (FILE *__restrict __stream,
 405                             const char *__restrict __format, ...) __wur;
 406 extern int __isoc99_scanf (const char *__restrict __format, ...) __wur;
 407 extern int __isoc99_sscanf (const char *__restrict __s,
 408                             const char *__restrict __format, ...) __THROW;
 409 #  define fscanf __isoc99_fscanf
 410 #  define scanf __isoc99_scanf
 411 #  define sscanf __isoc99_sscanf
 412 # endif
 413 #endif
 414
 415 #ifdef  __USE_ISOC99
 416 /* Read formatted input from S into argument list ARG.
 417
 418    This function is a possible cancellation point and therefore not
 419    marked with __THROW.  */
 420 extern int vfscanf (FILE *__restrict __s, const char *__restrict __format,
 421                     _G_va_list __arg)
 422      __attribute__ ((__format__ (__scanf__, 2, 0))) __wur;
 423
 424 /* Read formatted input from stdin into argument list ARG.
 425
 426    This function is a possible cancellation point and therefore not
 427    marked with __THROW.  */
 428 extern int vscanf (const char *__restrict __format, _G_va_list __arg)
 429      __attribute__ ((__format__ (__scanf__, 1, 0))) __wur;
 430
 431 /* Read formatted input from S into argument list ARG.  */
 432 extern int vsscanf (const char *__restrict __s,
 433                     const char *__restrict __format, _G_va_list __arg)
 434      __THROW __attribute__ ((__format__ (__scanf__, 2, 0)));
 435
 436 # if !defined __USE_GNU \
 437      && (!defined __LDBL_COMPAT || !defined __REDIRECT) \
 438      && (defined __STRICT_ANSI__ || defined __USE_XOPEN2K)
 439 #  ifdef __REDIRECT
 440 /* For strict ISO C99 or POSIX compliance disallow %as, %aS and %a[
 441    GNU extension which conflicts with valid %a followed by letter
 442    s, S or [.  */
 443 extern int __REDIRECT (vfscanf,
 444                        (FILE *__restrict __s,
 445                         const char *__restrict __format, _G_va_list __arg),
 446                        __isoc99_vfscanf)
 447      __attribute__ ((__format__ (__scanf__, 2, 0))) __wur;
 448 extern int __REDIRECT (vscanf, (const char *__restrict __format,
 449                                 _G_va_list __arg), __isoc99_vscanf)
 450      __attribute__ ((__format__ (__scanf__, 1, 0))) __wur;
 451 extern int __REDIRECT_NTH (vsscanf,
 452                            (const char *__restrict __s,
 453                             const char *__restrict __format,
 454                             _G_va_list __arg), __isoc99_vsscanf)
 455      __attribute__ ((__format__ (__scanf__, 2, 0)));
 456 #  else
 457 extern int __isoc99_vfscanf (FILE *__restrict __s,
 458                              const char *__restrict __format,
 459                              _G_va_list __arg) __wur;
 460 extern int __isoc99_vscanf (const char *__restrict __format,
 461                             _G_va_list __arg) __wur;
 462 extern int __isoc99_vsscanf (const char *__restrict __s,
 463                              const char *__restrict __format,
 464                              _G_va_list __arg) __THROW;
 465 #   define vfscanf __isoc99_vfscanf
 466 #   define vscanf __isoc99_vscanf
 467 #   define vsscanf __isoc99_vsscanf
 468 #  endif
 469 # endif
 470 #endif /* Use ISO C9x.  */
 471
 472
 473 /* Read a character from STREAM.
 474
 475    These functions are possible cancellation points and therefore not
 476    marked with __THROW.  */
 477 extern int fgetc (FILE *__stream);
 478 extern int getc (FILE *__stream);
 479
 480 /* Read a character from stdin.
 481
 482    This function is a possible cancellation point and therefore not
 483    marked with __THROW.  */
 484 extern int getchar (void);
 485
 486 /* The C standard explicitly says this is a macro, so we always do the
 487    optimization for it.  */
 488 #define getc(_fp) _IO_getc (_fp)
 489
 490 #ifdef __USE_POSIX199506
 491 /* These are defined in POSIX.1:1996.
 492
 493    These functions are possible cancellation points and therefore not
 494    marked with __THROW.  */
 495 extern int getc_unlocked (FILE *__stream);
 496 extern int getchar_unlocked (void);
 497 #endif /* Use POSIX.  */
 498
 499 #ifdef __USE_MISC
 500 /* Faster version when locking is not necessary.
 501
 502    This function is not part of POSIX and therefore no official
 503    cancellation point.  But due to similarity with an POSIX interface
 504    or due to the implementation it is a cancellation point and
 505    therefore not marked with __THROW.  */
 506 extern int fgetc_unlocked (FILE *__stream);
 507 #endif /* Use MISC.  */
 508
 509
 510 /* Write a character to STREAM.
 511
 512    These functions are possible cancellation points and therefore not
 513    marked with __THROW.
 514
 515    These functions is a possible cancellation point and therefore not
 516    marked with __THROW.  */
 517 extern int fputc (int __c, FILE *__stream);
 518 extern int putc (int __c, FILE *__stream);
 519
 520 /* Write a character to stdout.
 521
 522    This function is a possible cancellation point and therefore not
 523    marked with __THROW.  */
 524 extern int putchar (int __c);
 525
 526 /* The C standard explicitly says this can be a macro,
 527    so we always do the optimization for it.  */
 528 #define putc(_ch, _fp) _IO_putc (_ch, _fp)
 529
 530 #ifdef __USE_MISC
 531 /* Faster version when locking is not necessary.
 532
 533    This function is not part of POSIX and therefore no official
 534    cancellation point.  But due to similarity with an POSIX interface
 535    or due to the implementation it is a cancellation point and
 536    therefore not marked with __THROW.  */
 537 extern int fputc_unlocked (int __c, FILE *__stream);
 538 #endif /* Use MISC.  */
 539
 540 #ifdef __USE_POSIX199506
 541 /* These are defined in POSIX.1:1996.
 542
 543    These functions are possible cancellation points and therefore not
 544    marked with __THROW.  */
 545 extern int putc_unlocked (int __c, FILE *__stream);
 546 extern int putchar_unlocked (int __c);
 547 #endif /* Use POSIX.  */
 548
 549
 550 #if defined __USE_MISC \
 551     || (defined __USE_XOPEN && !defined __USE_XOPEN2K)
 552 /* Get a word (int) from STREAM.  */
 553 extern int getw (FILE *__stream);
 554
 555 /* Write a word (int) to STREAM.  */
 556 extern int putw (int __w, FILE *__stream);
 557 #endif
 558
 559
 560 /* Get a newline-terminated string of finite length from STREAM.
 561
 562    This function is a possible cancellation point and therefore not
 563    marked with __THROW.  */
 564 extern char *fgets (char *__restrict __s, int __n, FILE *__restrict __stream)
 565      __wur;
 566
 567 #if __GLIBC_USE (DEPRECATED_GETS)
 568 /* Get a newline-terminated string from stdin, removing the newline.
 569
 570    This function is impossible to use safely.  It has been officially
 571    removed from ISO C11 and ISO C++14, and we have also removed it
 572    from the _GNU_SOURCE feature list.  It remains available when
 573    explicitly using an old ISO C, Unix, or POSIX standard.
 574
 575    This function is a possible cancellation point and therefore not
 576    marked with __THROW.  */
 577 extern char *gets (char *__s) __wur __attribute_deprecated__;
 578 #endif
 579
 580 #ifdef __USE_GNU
 581 /* This function does the same as `fgets' but does not lock the stream.
 582
 583    This function is not part of POSIX and therefore no official
 584    cancellation point.  But due to similarity with an POSIX interface
 585    or due to the implementation it is a cancellation point and
 586    therefore not marked with __THROW.  */
 587 extern char *fgets_unlocked (char *__restrict __s, int __n,
 588                              FILE *__restrict __stream) __wur;
 589 #endif
 590
 591
 592 #if defined __USE_XOPEN2K8 || __GLIBC_USE (LIB_EXT2)
 593 /* Read up to (and including) a DELIMITER from STREAM into *LINEPTR
 594    (and null-terminate it). *LINEPTR is a pointer returned from malloc (or
 595    NULL), pointing to *N characters of space.  It is realloc'd as
 596    necessary.  Returns the number of characters read (not including the
 597    null terminator), or -1 on error or EOF.
 598
 599    These functions are not part of POSIX and therefore no official
 600    cancellation point.  But due to similarity with an POSIX interface
 601    or due to the implementation they are cancellation points and
 602    therefore not marked with __THROW.  */
 603 extern _IO_ssize_t __getdelim (char **__restrict __lineptr,
 604                                size_t *__restrict __n, int __delimiter,
 605                                FILE *__restrict __stream) __wur;
 606 extern _IO_ssize_t getdelim (char **__restrict __lineptr,
 607                              size_t *__restrict __n, int __delimiter,
 608                              FILE *__restrict __stream) __wur;
 609
 610 /* Like `getdelim', but reads up to a newline.
 611
 612    This function is not part of POSIX and therefore no official
 613    cancellation point.  But due to similarity with an POSIX interface
 614    or due to the implementation it is a cancellation point and
 615    therefore not marked with __THROW.  */
 616 extern _IO_ssize_t getline (char **__restrict __lineptr,
 617                             size_t *__restrict __n,
 618                             FILE *__restrict __stream) __wur;
 619 #endif
 620
 621
 622 /* Write a string to STREAM.
 623
 624    This function is a possible cancellation point and therefore not
 625    marked with __THROW.  */
 626 extern int fputs (const char *__restrict __s, FILE *__restrict __stream);
 627
 628 /* Write a string, followed by a newline, to stdout.
 629
 630    This function is a possible cancellation point and therefore not
 631    marked with __THROW.  */
 632 extern int puts (const char *__s);
 633
 634
 635 /* Push a character back onto the input buffer of STREAM.
 636
 637    This function is a possible cancellation point and therefore not
 638    marked with __THROW.  */
 639 extern int ungetc (int __c, FILE *__stream);
 640
 641
 642 /* Read chunks of generic data from STREAM.
 643
 644    This function is a possible cancellation point and therefore not
 645    marked with __THROW.  */
 646 extern size_t fread (void *__restrict __ptr, size_t __size,
 647                      size_t __n, FILE *__restrict __stream) __wur;
 648 /* Write chunks of generic data to STREAM.
 649
 650    This function is a possible cancellation point and therefore not
 651    marked with __THROW.  */
 652 extern size_t fwrite (const void *__restrict __ptr, size_t __size,
 653                       size_t __n, FILE *__restrict __s);
 654
 655 #ifdef __USE_GNU
 656 /* This function does the same as `fputs' but does not lock the stream.
 657
 658    This function is not part of POSIX and therefore no official
 659    cancellation point.  But due to similarity with an POSIX interface
 660    or due to the implementation it is a cancellation point and
 661    therefore not marked with __THROW.  */
 662 extern int fputs_unlocked (const char *__restrict __s,
 663                            FILE *__restrict __stream);
 664 #endif
 665
 666 #ifdef __USE_MISC
 667 /* Faster versions when locking is not necessary.
 668
 669    These functions are not part of POSIX and therefore no official
 670    cancellation point.  But due to similarity with an POSIX interface
 671    or due to the implementation they are cancellation points and
 672    therefore not marked with __THROW.  */
 673 extern size_t fread_unlocked (void *__restrict __ptr, size_t __size,
 674                               size_t __n, FILE *__restrict __stream) __wur;
 675 extern size_t fwrite_unlocked (const void *__restrict __ptr, size_t __size,
 676                                size_t __n, FILE *__restrict __stream);
 677 #endif
 678
 679
 680 /* Seek to a certain position on STREAM.
 681
 682    This function is a possible cancellation point and therefore not
 683    marked with __THROW.  */
 684 extern int fseek (FILE *__stream, long int __off, int __whence);
 685 /* Return the current position of STREAM.
 686
 687    This function is a possible cancellation point and therefore not
 688    marked with __THROW.  */
 689 extern long int ftell (FILE *__stream) __wur;
 690 /* Rewind to the beginning of STREAM.
 691
 692    This function is a possible cancellation point and therefore not
 693    marked with __THROW.  */
 694 extern void rewind (FILE *__stream);
 695
 696 /* The Single Unix Specification, Version 2, specifies an alternative,
 697    more adequate interface for the two functions above which deal with
 698    file offset.  `long int' is not the right type.  These definitions
 699    are originally defined in the Large File Support API.  */
 700
 701 #if defined __USE_LARGEFILE || defined __USE_XOPEN2K
 702 # ifndef __USE_FILE_OFFSET64
 703 /* Seek to a certain position on STREAM.
 704
 705    This function is a possible cancellation point and therefore not
 706    marked with __THROW.  */
 707 extern int fseeko (FILE *__stream, __off_t __off, int __whence);
 708 /* Return the current position of STREAM.
 709
 710    This function is a possible cancellation point and therefore not
 711    marked with __THROW.  */
 712 extern __off_t ftello (FILE *__stream) __wur;
 713 # else
 714 #  ifdef __REDIRECT
 715 extern int __REDIRECT (fseeko,
 716                        (FILE *__stream, __off64_t __off, int __whence),
 717                        fseeko64);
 718 extern __off64_t __REDIRECT (ftello, (FILE *__stream), ftello64);
 719 #  else
 720 #   define fseeko fseeko64
 721 #   define ftello ftello64
 722 #  endif
 723 # endif
 724 #endif
 725
 726 #ifndef __USE_FILE_OFFSET64
 727 /* Get STREAM's position.
 728
 729    This function is a possible cancellation point and therefore not
 730    marked with __THROW.  */
 731 extern int fgetpos (FILE *__restrict __stream, fpos_t *__restrict __pos);
 732 /* Set STREAM's position.
 733
 734    This function is a possible cancellation point and therefore not
 735    marked with __THROW.  */
 736 extern int fsetpos (FILE *__stream, const fpos_t *__pos);
 737 #else
 738 # ifdef __REDIRECT
 739 extern int __REDIRECT (fgetpos, (FILE *__restrict __stream,
 740                                  fpos_t *__restrict __pos), fgetpos64);
 741 extern int __REDIRECT (fsetpos,
 742                        (FILE *__stream, const fpos_t *__pos), fsetpos64);
 743 # else
 744 #  define fgetpos fgetpos64
 745 #  define fsetpos fsetpos64
 746 # endif
 747 #endif
 748
 749 #ifdef __USE_LARGEFILE64
 750 extern int fseeko64 (FILE *__stream, __off64_t __off, int __whence);
 751 extern __off64_t ftello64 (FILE *__stream) __wur;
 752 extern int fgetpos64 (FILE *__restrict __stream, fpos64_t *__restrict __pos);
 753 extern int fsetpos64 (FILE *__stream, const fpos64_t *__pos);
 754 #endif
 755
 756 /* Clear the error and EOF indicators for STREAM.  */
 757 extern void clearerr (FILE *__stream) __THROW;
 758 /* Return the EOF indicator for STREAM.  */
 759 extern int feof (FILE *__stream) __THROW __wur;
 760 /* Return the error indicator for STREAM.  */
 761 extern int ferror (FILE *__stream) __THROW __wur;
 762
 763 #ifdef __USE_MISC
 764 /* Faster versions when locking is not required.  */
 765 extern void clearerr_unlocked (FILE *__stream) __THROW;
 766 extern int feof_unlocked (FILE *__stream) __THROW __wur;
 767 extern int ferror_unlocked (FILE *__stream) __THROW __wur;
 768 #endif
 769
 770
 771 /* Print a message describing the meaning of the value of errno.
 772
 773    This function is a possible cancellation point and therefore not
 774    marked with __THROW.  */
 775 extern void perror (const char *__s);
 776
 777 /* Provide the declarations for `sys_errlist' and `sys_nerr' if they
 778    are available on this system.  Even if available, these variables
 779    should not be used directly.  The `strerror' function provides
 780    all the necessary functionality.  */
 781 #include <bits/sys_errlist.h>
 782
 783
 784 #ifdef  __USE_POSIX
 785 /* Return the system file descriptor for STREAM.  */
 786 extern int fileno (FILE *__stream) __THROW __wur;
 787 #endif /* Use POSIX.  */
 788
 789 #ifdef __USE_MISC
 790 /* Faster version when locking is not required.  */
 791 extern int fileno_unlocked (FILE *__stream) __THROW __wur;
 792 #endif
 793
 794
 795 #ifdef __USE_POSIX2
 796 /* Create a new stream connected to a pipe running the given command.
 797
 798    This function is a possible cancellation point and therefore not
 799    marked with __THROW.  */
 800 extern FILE *popen (const char *__command, const char *__modes) __wur;
 801
 802 /* Close a stream opened by popen and return the status of its child.
 803
 804    This function is a possible cancellation point and therefore not
 805    marked with __THROW.  */
 806 extern int pclose (FILE *__stream);
 807 #endif
 808
 809
 810 #ifdef  __USE_POSIX
 811 /* Return the name of the controlling terminal.  */
 812 extern char *ctermid (char *__s) __THROW;
 813 #endif /* Use POSIX.  */
 814
 815
 816 #if (defined __USE_XOPEN && !defined __USE_XOPEN2K) || defined __USE_GNU
 817 /* Return the name of the current user.  */
 818 extern char *cuserid (char *__s);
 819 #endif /* Use X/Open, but not issue 6.  */
 820
 821
 822 #ifdef  __USE_GNU
 823 struct obstack;                 /* See <obstack.h>.  */
 824
 825 /* Write formatted output to an obstack.  */
 826 extern int obstack_printf (struct obstack *__restrict __obstack,
 827                            const char *__restrict __format, ...)
 828      __THROWNL __attribute__ ((__format__ (__printf__, 2, 3)));
 829 extern int obstack_vprintf (struct obstack *__restrict __obstack,
 830                             const char *__restrict __format,
 831                             _G_va_list __args)
 832      __THROWNL __attribute__ ((__format__ (__printf__, 2, 0)));
 833 #endif /* Use GNU.  */
 834
 835
 836 #ifdef __USE_POSIX199506
 837 /* These are defined in POSIX.1:1996.  */
 838
 839 /* Acquire ownership of STREAM.  */
 840 extern void flockfile (FILE *__stream) __THROW;
 841
 842 /* Try to acquire ownership of STREAM but do not block if it is not
 843    possible.  */
 844 extern int ftrylockfile (FILE *__stream) __THROW __wur;
 845
 846 /* Relinquish the ownership granted for STREAM.  */
 847 extern void funlockfile (FILE *__stream) __THROW;
 848 #endif /* POSIX */
 849
 850 #if defined __USE_XOPEN && !defined __USE_XOPEN2K && !defined __USE_GNU
 851 /*  X/Open Issues 1-5 required getopt to be declared in this
 852    header.  It was removed in Issue 6.  GNU follows Issue 6.  */
 853 # include <bits/getopt_posix.h>
 854 #endif
 855
 856 /* If we are compiling with optimizing read this file.  It contains
 857    several optimizing inline functions and macros.  */
 858 #ifdef __USE_EXTERN_INLINES
 859 # include <bits/stdio.h>
 860 #endif
 861 #if __USE_FORTIFY_LEVEL > 0 && defined __fortify_function
 862 # include <bits/stdio2.h>
 863 #endif
 864 #ifdef __LDBL_COMPAT
 865 # include <bits/stdio-ldbl.h>
 866 #endif
 867
 868 __END_DECLS
 869
 870 #endif /* <stdio.h> included.  */