libio/stdio.h

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