Branch data Line data Source code
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 : 0 : 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 : 24 : extern int snprintf (char *__restrict __s, size_t __maxlen,
384 : : const char *__restrict __format, ...)
385 : : __THROWNL __attribute__ ((__format__ (__printf__, 3, 4)));
386 : :
387 : 24 : 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 : 4 : 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. */
|
