_stdio.h (20375B) - Raw
1 /* 2 * Copyright (c) 2000, 2005, 2007, 2009, 2010, 2023 Apple Inc. All rights reserved. 3 * 4 * @APPLE_LICENSE_HEADER_START@ 5 * 6 * This file contains Original Code and/or Modifications of Original Code 7 * as defined in and that are subject to the Apple Public Source License 8 * Version 2.0 (the 'License'). You may not use this file except in 9 * compliance with the License. Please obtain a copy of the License at 10 * http://www.opensource.apple.com/apsl/ and read it before using this 11 * file. 12 * 13 * The Original Code and all software distributed under the License are 14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 18 * Please see the License for the specific language governing rights and 19 * limitations under the License. 20 * 21 * @APPLE_LICENSE_HEADER_END@ 22 */ 23 /*- 24 * Copyright (c) 1990, 1993 25 * The Regents of the University of California. All rights reserved. 26 * 27 * This code is derived from software contributed to Berkeley by 28 * Chris Torek. 29 * 30 * Redistribution and use in source and binary forms, with or without 31 * modification, are permitted provided that the following conditions 32 * are met: 33 * 1. Redistributions of source code must retain the above copyright 34 * notice, this list of conditions and the following disclaimer. 35 * 2. Redistributions in binary form must reproduce the above copyright 36 * notice, this list of conditions and the following disclaimer in the 37 * documentation and/or other materials provided with the distribution. 38 * 3. All advertising materials mentioning features or use of this software 39 * must display the following acknowledgement: 40 * This product includes software developed by the University of 41 * California, Berkeley and its contributors. 42 * 4. Neither the name of the University nor the names of its contributors 43 * may be used to endorse or promote products derived from this software 44 * without specific prior written permission. 45 * 46 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 47 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 48 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 49 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 50 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 51 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 52 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 53 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 54 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 55 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 56 * SUCH DAMAGE. 57 * 58 * @(#)stdio.h 8.5 (Berkeley) 4/29/95 59 */ 60 61 /* 62 * Common header for stdio.h and xlocale/_stdio.h 63 */ 64 65 #ifndef _STDIO_H_ 66 #define _STDIO_H_ 67 #define __STDIO_H_ 68 69 #include <_bounds.h> 70 #include <sys/cdefs.h> 71 #include <Availability.h> 72 73 #include <_types.h> 74 75 /* DO NOT REMOVE THIS COMMENT: fixincludes needs to see: 76 * __gnuc_va_list and include <stdarg.h> */ 77 #include <sys/_types/_va_list.h> 78 #include <sys/_types/_size_t.h> 79 #include <sys/_types/_null.h> 80 81 #include <sys/stdio.h> 82 #include <_printf.h> 83 84 _LIBC_SINGLE_BY_DEFAULT() 85 86 typedef __darwin_off_t fpos_t; 87 88 #define _FSTDIO /* Define for new stdio with functions. */ 89 90 /* 91 * NB: to fit things in six character monocase externals, the stdio 92 * code uses the prefix `__s' for stdio objects, typically followed 93 * by a three-character attempt at a mnemonic. 94 */ 95 96 /* stdio buffers */ 97 struct __sbuf { 98 unsigned char *_LIBC_COUNT(_size) _base; 99 int _size; 100 }; 101 102 /* hold a buncha junk that would grow the ABI */ 103 struct __sFILEX; 104 105 /* 106 * stdio state variables. 107 * 108 * The following always hold: 109 * 110 * if (_flags&(__SLBF|__SWR)) == (__SLBF|__SWR), 111 * _lbfsize is -_bf._size, else _lbfsize is 0 112 * if _flags&__SRD, _w is 0 113 * if _flags&__SWR, _r is 0 114 * 115 * This ensures that the getc and putc macros (or inline functions) never 116 * try to write or read from a file that is in `read' or `write' mode. 117 * (Moreover, they can, and do, automatically switch from read mode to 118 * write mode, and back, on "r+" and "w+" files.) 119 * 120 * _lbfsize is used only to make the inline line-buffered output stream 121 * code as compact as possible. 122 * 123 * _ub, _up, and _ur are used when ungetc() pushes back more characters 124 * than fit in the current _bf, or when ungetc() pushes back a character 125 * that does not match the previous one in _bf. When this happens, 126 * _ub._base becomes non-nil (i.e., a stream has ungetc() data iff 127 * _ub._base!=NULL) and _up and _ur save the current values of _p and _r. 128 * 129 * NB: see WARNING above before changing the layout of this structure! 130 */ 131 typedef struct __sFILE { 132 unsigned char *_LIBC_UNSAFE_INDEXABLE _p; /* current position in (some) buffer */ 133 int _r; /* read space left for getc() */ 134 int _w; /* write space left for putc() */ 135 short _flags; /* flags, below; this FILE is free if 0 */ 136 short _file; /* fileno, if Unix descriptor, else -1 */ 137 struct __sbuf _bf; /* the buffer (at least 1 byte, if !NULL) */ 138 int _lbfsize; /* 0 or -_bf._size, for inline putc */ 139 140 /* operations */ 141 void *_cookie; /* cookie passed to io functions */ 142 int (* _Nullable _close)(void *); 143 int (* _Nullable _read) (void *, char *_LIBC_COUNT(__n), int __n); 144 fpos_t (* _Nullable _seek) (void *, fpos_t, int); 145 int (* _Nullable _write)(void *, const char *_LIBC_COUNT(__n), int __n); 146 147 /* separate buffer for long sequences of ungetc() */ 148 struct __sbuf _ub; /* ungetc buffer */ 149 struct __sFILEX *_extra; /* additions to FILE to not break ABI */ 150 int _ur; /* saved _r when _r is counting ungetc data */ 151 152 /* tricks to meet minimum requirements even when malloc() fails */ 153 unsigned char _ubuf[3]; /* guarantee an ungetc() buffer */ 154 unsigned char _nbuf[1]; /* guarantee a getc() buffer */ 155 156 /* separate buffer for fgetln() when line crosses buffer boundary */ 157 struct __sbuf _lb; /* buffer for fgetln() */ 158 159 /* Unix stdio files get aligned to block boundaries on fseek() */ 160 int _blksize; /* stat.st_blksize (may be != _bf._size) */ 161 fpos_t _offset; /* current lseek offset (see WARNING) */ 162 } FILE; 163 164 #include <sys/_types/_seek_set.h> 165 166 __BEGIN_DECLS 167 extern FILE *__stdinp __swift_nonisolated_unsafe; 168 extern FILE *__stdoutp __swift_nonisolated_unsafe; 169 extern FILE *__stderrp __swift_nonisolated_unsafe; 170 __END_DECLS 171 172 #define __SLBF 0x0001 /* line buffered */ 173 #define __SNBF 0x0002 /* unbuffered */ 174 #define __SRD 0x0004 /* OK to read */ 175 #define __SWR 0x0008 /* OK to write */ 176 /* RD and WR are never simultaneously asserted */ 177 #define __SRW 0x0010 /* open for reading & writing */ 178 #define __SEOF 0x0020 /* found EOF */ 179 #define __SERR 0x0040 /* found error */ 180 #define __SMBF 0x0080 /* _buf is from malloc */ 181 #define __SAPP 0x0100 /* fdopen()ed in append mode */ 182 #define __SSTR 0x0200 /* this is an sprintf/snprintf string */ 183 #define __SOPT 0x0400 /* do fseek() optimisation */ 184 #define __SNPT 0x0800 /* do not do fseek() optimisation */ 185 #define __SOFF 0x1000 /* set iff _offset is in fact correct */ 186 #define __SMOD 0x2000 /* true => fgetln modified _p text */ 187 #define __SALC 0x4000 /* allocate string space dynamically */ 188 #define __SIGN 0x8000 /* ignore this file in _fwalk */ 189 190 /* 191 * The following three definitions are for ANSI C, which took them 192 * from System V, which brilliantly took internal interface macros and 193 * made them official arguments to setvbuf(), without renaming them. 194 * Hence, these ugly _IOxxx names are *supposed* to appear in user code. 195 * 196 * Although numbered as their counterparts above, the implementation 197 * does not rely on this. 198 */ 199 #define _IOFBF 0 /* setvbuf should set fully buffered */ 200 #define _IOLBF 1 /* setvbuf should set line buffered */ 201 #define _IONBF 2 /* setvbuf should set unbuffered */ 202 203 #define BUFSIZ 1024 /* size of buffer used by setbuf */ 204 #define EOF (-1) 205 206 /* must be == _POSIX_STREAM_MAX <limits.h> */ 207 #define FOPEN_MAX 20 /* must be <= OPEN_MAX <sys/syslimits.h> */ 208 #define FILENAME_MAX 1024 /* must be <= PATH_MAX <sys/syslimits.h> */ 209 210 /* System V/ANSI C; this is the wrong way to do this, do *not* use these. */ 211 #ifndef _ANSI_SOURCE 212 #define P_tmpdir "/var/tmp/" 213 #endif 214 #define L_tmpnam 1024 /* XXX must be == PATH_MAX */ 215 #define TMP_MAX 308915776 216 217 #define stdin __stdinp 218 #define stdout __stdoutp 219 #define stderr __stderrp 220 221 #ifdef _DARWIN_UNLIMITED_STREAMS 222 #if defined(__IPHONE_OS_VERSION_MIN_REQUIRED) && __IPHONE_OS_VERSION_MIN_REQUIRED < __IPHONE_3_2 223 #error "_DARWIN_UNLIMITED_STREAMS specified, but -miphoneos-version-min version does not support it." 224 #elif defined(__MAC_OS_X_VERSION_MIN_REQUIRED) && __MAC_OS_X_VERSION_MIN_REQUIRED < __MAC_10_6 225 #error "_DARWIN_UNLIMITED_STREAMS specified, but -mmacosx-version-min version does not support it." 226 #endif 227 #endif 228 229 /* ANSI-C */ 230 231 __BEGIN_DECLS 232 void clearerr(FILE *); 233 int fclose(FILE *); 234 int feof(FILE *); 235 int ferror(FILE *); 236 int fflush(FILE *); 237 int fgetc(FILE *); 238 int fgetpos(FILE * __restrict, fpos_t *); 239 char *_LIBC_CSTR fgets(char * __restrict _LIBC_COUNT(__size), int __size, FILE *); 240 #if defined(_DARWIN_UNLIMITED_STREAMS) || defined(_DARWIN_C_SOURCE) 241 FILE *fopen(const char * __restrict __filename, const char * __restrict __mode) __DARWIN_ALIAS_STARTING(__MAC_10_6, __IPHONE_3_2, __DARWIN_EXTSN(fopen)); 242 #else /* !_DARWIN_UNLIMITED_STREAMS && !_DARWIN_C_SOURCE */ 243 FILE *fopen(const char * __restrict __filename, const char * __restrict __mode) __DARWIN_ALIAS_STARTING(__MAC_10_6, __IPHONE_2_0, __DARWIN_ALIAS(fopen)); 244 #endif /* (DARWIN_UNLIMITED_STREAMS || _DARWIN_C_SOURCE) */ 245 int fprintf(FILE * __restrict, const char * __restrict, ...) __printflike(2, 3); 246 int fputc(int, FILE *); 247 int fputs(const char * __restrict, FILE * __restrict) __DARWIN_ALIAS(fputs); 248 size_t fread(void * __restrict _LIBC_SIZE(__size * __nitems) __ptr, size_t __size, size_t __nitems, FILE * __restrict __stream); 249 FILE *freopen(const char * __restrict, const char * __restrict, 250 FILE * __restrict) __DARWIN_ALIAS(freopen); 251 int fscanf(FILE * __restrict, const char * __restrict, ...) __scanflike(2, 3); 252 int fseek(FILE *, long, int); 253 int fsetpos(FILE *, const fpos_t *); 254 long ftell(FILE *); 255 size_t fwrite(const void * __restrict _LIBC_SIZE(__size * __nitems) __ptr, size_t __size, size_t __nitems, FILE * __restrict __stream) __DARWIN_ALIAS(fwrite); 256 int getc(FILE *); 257 int getchar(void); 258 259 #if !defined(_POSIX_C_SOURCE) 260 __deprecated_msg("This function is provided for compatibility reasons only. Due to security concerns inherent in the design of gets(3), it is highly recommended that you use fgets(3) instead.") 261 #endif 262 char *_LIBC_CSTR gets(char *_LIBC_UNSAFE_INDEXABLE) _LIBC_PTRCHECK_REPLACED(fgets); 263 264 void perror(const char *) __cold; 265 int putc(int, FILE *); 266 int putchar(int); 267 int puts(const char *); 268 int remove(const char *); 269 int rename (const char *__old, const char *__new); 270 void rewind(FILE *); 271 int scanf(const char * __restrict, ...) __scanflike(1, 2); 272 void setbuf(FILE * __restrict, char * __restrict _LIBC_COUNT_OR_NULL(BUFSIZ)); 273 int setvbuf(FILE * __restrict, char * __restrict _LIBC_COUNT_OR_NULL(__size), int, size_t __size); 274 275 __swift_unavailable("Use snprintf instead.") 276 _LIBC_PTRCHECK_REPLACED("snprintf") 277 #if !defined(_POSIX_C_SOURCE) 278 __deprecated_msg("This function is provided for compatibility reasons only. Due to security concerns inherent in the design of sprintf(3), it is highly recommended that you use snprintf(3) instead.") 279 #endif 280 int sprintf(char * __restrict _LIBC_UNSAFE_INDEXABLE, const char * __restrict, ...) __printflike(2, 3) _LIBC_PTRCHECK_REPLACED(snprintf); 281 282 int sscanf(const char * __restrict, const char * __restrict, ...) __scanflike(2, 3); 283 FILE *tmpfile(void); 284 285 __swift_unavailable("Use mkstemp(3) instead.") 286 #if !defined(_POSIX_C_SOURCE) 287 __deprecated_msg("This function is provided for compatibility reasons only. Due to security concerns inherent in the design of tmpnam(3), it is highly recommended that you use mkstemp(3) instead.") 288 #endif 289 char *_LIBC_CSTR tmpnam(char *_LIBC_COUNT(L_tmpnam)); 290 291 int ungetc(int, FILE *); 292 int vfprintf(FILE * __restrict, const char * __restrict, va_list) __printflike(2, 0); 293 int vprintf(const char * __restrict, va_list) __printflike(1, 0); 294 295 __swift_unavailable("Use vsnprintf instead.") 296 _LIBC_PTRCHECK_REPLACED("vsnprintf") 297 #if !defined(_POSIX_C_SOURCE) 298 __deprecated_msg("This function is provided for compatibility reasons only. Due to security concerns inherent in the design of sprintf(3), it is highly recommended that you use vsnprintf(3) instead.") 299 #endif 300 int vsprintf(char * __restrict _LIBC_UNSAFE_INDEXABLE, const char * __restrict, va_list) __printflike(2, 0) _LIBC_PTRCHECK_REPLACED(vsnprintf); 301 __END_DECLS 302 303 304 305 /* Additional functionality provided by: 306 * POSIX.1-1988 307 */ 308 309 #if __DARWIN_C_LEVEL >= 198808L 310 311 #include <_ctermid.h> 312 313 __BEGIN_DECLS 314 315 #if defined(_DARWIN_UNLIMITED_STREAMS) || defined(_DARWIN_C_SOURCE) 316 FILE *fdopen(int, const char *) __DARWIN_ALIAS_STARTING(__MAC_10_6, __IPHONE_3_2, __DARWIN_EXTSN(fdopen)); 317 #else /* !_DARWIN_UNLIMITED_STREAMS && !_DARWIN_C_SOURCE */ 318 FILE *fdopen(int, const char *) __DARWIN_ALIAS_STARTING(__MAC_10_6, __IPHONE_2_0, __DARWIN_ALIAS(fdopen)); 319 #endif /* (DARWIN_UNLIMITED_STREAMS || _DARWIN_C_SOURCE) */ 320 int fileno(FILE *); 321 __END_DECLS 322 #endif /* __DARWIN_C_LEVEL >= 198808L */ 323 324 325 /* Additional functionality provided by: 326 * POSIX.2-1992 C Language Binding Option 327 */ 328 329 #if __DARWIN_C_LEVEL >= 199209L 330 __BEGIN_DECLS 331 int pclose(FILE *) __swift_unavailable("Use posix_spawn APIs or NSTask instead. (On iOS, process spawning is unavailable.)"); 332 #if defined(_DARWIN_UNLIMITED_STREAMS) || defined(_DARWIN_C_SOURCE) 333 FILE *popen(const char *, const char *) __DARWIN_ALIAS_STARTING(__MAC_10_6, __IPHONE_3_2, __DARWIN_EXTSN(popen)) __swift_unavailable("Use posix_spawn APIs or NSTask instead. (On iOS, process spawning is unavailable.)"); 334 #else /* !_DARWIN_UNLIMITED_STREAMS && !_DARWIN_C_SOURCE */ 335 FILE *popen(const char *, const char *) __DARWIN_ALIAS_STARTING(__MAC_10_6, __IPHONE_2_0, __DARWIN_ALIAS(popen)) __swift_unavailable("Use posix_spawn APIs or NSTask instead. (On iOS, process spawning is unavailable.)"); 336 #endif /* (DARWIN_UNLIMITED_STREAMS || _DARWIN_C_SOURCE) */ 337 __END_DECLS 338 #endif /* __DARWIN_C_LEVEL >= 199209L */ 339 340 /* Additional functionality provided by: 341 * POSIX.1c-1995, 342 * POSIX.1i-1995, 343 * and the omnibus ISO/IEC 9945-1: 1996 344 */ 345 346 #if __DARWIN_C_LEVEL >= 199506L 347 348 /* Functions internal to the implementation. */ 349 __BEGIN_DECLS 350 int __srget(FILE *); 351 int __svfscanf(FILE *, const char *, va_list) __scanflike(2, 0); 352 int __swbuf(int, FILE *); 353 __END_DECLS 354 355 /* 356 * The __sfoo macros are here so that we can 357 * define function versions in the C library. 358 */ 359 #define __sgetc(p) (--(p)->_r < 0 ? __srget(p) : (int)(*(p)->_p++)) 360 #if defined(__GNUC__) && defined(__STDC__) 361 __header_always_inline int __sputc(int _c, FILE *_p) { 362 if (--_p->_w >= 0 || (_p->_w >= _p->_lbfsize && (char)_c != '\n')) 363 return (*_p->_p++ = _c); 364 else 365 return (__swbuf(_c, _p)); 366 } 367 #else 368 /* 369 * This has been tuned to generate reasonable code on the vax using pcc. 370 */ 371 #define __sputc(c, p) \ 372 (--(p)->_w < 0 ? \ 373 (p)->_w >= (p)->_lbfsize ? \ 374 (*(p)->_p = (c)), *(p)->_p != '\n' ? \ 375 (int)*(p)->_p++ : \ 376 __swbuf('\n', p) : \ 377 __swbuf((int)(c), p) : \ 378 (*(p)->_p = (c), (int)*(p)->_p++)) 379 #endif 380 381 #define __sfeof(p) (((p)->_flags & __SEOF) != 0) 382 #define __sferror(p) (((p)->_flags & __SERR) != 0) 383 #define __sclearerr(p) ((void)((p)->_flags &= ~(__SERR|__SEOF))) 384 #define __sfileno(p) ((p)->_file) 385 386 __BEGIN_DECLS 387 void flockfile(FILE *); 388 int ftrylockfile(FILE *); 389 void funlockfile(FILE *); 390 int getc_unlocked(FILE *); 391 int getchar_unlocked(void); 392 int putc_unlocked(int, FILE *); 393 int putchar_unlocked(int); 394 395 /* Removed in Issue 6 */ 396 #if !defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE < 200112L 397 int getw(FILE *); 398 int putw(int, FILE *); 399 #endif 400 401 __swift_unavailable("Use mkstemp(3) instead.") 402 #if !defined(_POSIX_C_SOURCE) 403 __deprecated_msg("This function is provided for compatibility reasons only. Due to security concerns inherent in the design of tempnam(3), it is highly recommended that you use mkstemp(3) instead.") 404 #endif 405 char *_LIBC_CSTR tempnam(const char *__dir, const char *__prefix) __DARWIN_ALIAS(tempnam); 406 __END_DECLS 407 408 #ifndef lint 409 #define getc_unlocked(fp) __sgetc(fp) 410 #define putc_unlocked(x, fp) __sputc(x, fp) 411 #endif /* lint */ 412 413 #define getchar_unlocked() getc_unlocked(stdin) 414 #define putchar_unlocked(x) putc_unlocked(x, stdout) 415 #endif /* __DARWIN_C_LEVEL >= 199506L */ 416 417 418 419 /* Additional functionality provided by: 420 * POSIX.1-2001 421 * ISO C99 422 */ 423 424 #if __DARWIN_C_LEVEL >= 200112L 425 #include <sys/_types/_off_t.h> 426 427 __BEGIN_DECLS 428 int fseeko(FILE * __stream, off_t __offset, int __whence); 429 off_t ftello(FILE * __stream); 430 __END_DECLS 431 #endif /* __DARWIN_C_LEVEL >= 200112L */ 432 433 #if __DARWIN_C_LEVEL >= 200112L || defined(_C99_SOURCE) || defined(__cplusplus) 434 __BEGIN_DECLS 435 int snprintf(char * __restrict _LIBC_COUNT(__size) __str, size_t __size, const char * __restrict __format, ...) __printflike(3, 4); 436 int vfscanf(FILE * __restrict __stream, const char * __restrict __format, va_list) __scanflike(2, 0); 437 int vscanf(const char * __restrict __format, va_list) __scanflike(1, 0); 438 int vsnprintf(char * __restrict _LIBC_COUNT(__size) __str, size_t __size, const char * __restrict __format, va_list) __printflike(3, 0); 439 int vsscanf(const char * __restrict __str, const char * __restrict __format, va_list) __scanflike(2, 0); 440 __END_DECLS 441 #endif /* __DARWIN_C_LEVEL >= 200112L || defined(_C99_SOURCE) || defined(__cplusplus) */ 442 443 444 445 /* Additional functionality provided by: 446 * POSIX.1-2008 447 */ 448 449 #if __DARWIN_C_LEVEL >= 200809L 450 #include <sys/_types/_ssize_t.h> 451 452 __BEGIN_DECLS 453 int dprintf(int, const char * __restrict, ...) __printflike(2, 3) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3); 454 int vdprintf(int, const char * __restrict, va_list) __printflike(2, 0) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3); 455 ssize_t getdelim(char *_LIBC_COUNT(*__linecapp) *__restrict __linep, size_t * __restrict __linecapp, int __delimiter, FILE * __restrict __stream) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3); 456 ssize_t getline(char *_LIBC_COUNT(*__linecapp) *__restrict __linep, size_t * __restrict __linecapp, FILE * __restrict __stream) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3); 457 FILE *fmemopen(void * __restrict __buf _LIBC_SIZE(__size), size_t __size, const char * __restrict __mode) __API_AVAILABLE(macos(10.13), ios(11.0), tvos(11.0), watchos(4.0)); 458 FILE *open_memstream(char *_LIBC_COUNT(*__sizep) *__bufp, size_t *__sizep) __API_AVAILABLE(macos(10.13), ios(11.0), tvos(11.0), watchos(4.0)); 459 __END_DECLS 460 #endif /* __DARWIN_C_LEVEL >= 200809L */ 461 462 463 464 /* Darwin extensions */ 465 466 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL 467 __BEGIN_DECLS 468 extern __const int sys_nerr; /* perror(3) external variables */ 469 extern __const char *__const sys_errlist[]; 470 471 int asprintf(char *_LIBC_CSTR *__restrict, const char * __restrict, ...) __printflike(2, 3); 472 char *_LIBC_CSTR ctermid_r(char *_LIBC_COUNT(L_ctermid)); 473 char *_LIBC_COUNT(*__len) fgetln(FILE *, size_t *__len); 474 __const char *fmtcheck(const char *, const char *) __attribute__((format_arg(2))); 475 int fpurge(FILE *); 476 void setbuffer(FILE *, char *_LIBC_COUNT_OR_NULL(__size), int __size); 477 int setlinebuf(FILE *); 478 int vasprintf(char *_LIBC_CSTR *__restrict, const char * __restrict, va_list) __printflike(2, 0); 479 480 481 /* 482 * Stdio function-access interface. 483 */ 484 FILE *funopen(const void *, 485 int (* _Nullable)(void *, char *_LIBC_COUNT(__n), int __n), 486 int (* _Nullable)(void *, const char *_LIBC_COUNT(__n), int __n), 487 fpos_t (* _Nullable)(void *, fpos_t, int), 488 int (* _Nullable)(void *)); 489 __END_DECLS 490 #define fropen(cookie, fn) funopen(cookie, fn, 0, 0, 0) 491 #define fwopen(cookie, fn) funopen(cookie, 0, fn, 0, 0) 492 493 #define feof_unlocked(p) __sfeof(p) 494 #define ferror_unlocked(p) __sferror(p) 495 #define clearerr_unlocked(p) __sclearerr(p) 496 #define fileno_unlocked(p) __sfileno(p) 497 498 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */ 499 500 501 #if defined (__GNUC__) && _FORTIFY_SOURCE > 0 && !defined (__cplusplus) 502 /* Security checking functions. */ 503 #include <secure/_stdio.h> 504 #endif 505 506 #endif /* _STDIO_H_ */