libio/stdio.h

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