libio/stdio.h

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