Libc-498.1.5.tar.gz

[apple/libc.git] / include / stdio.h

diff --git a/include/stdio.h b/include/stdio.h
index e87d94a58c70f46d48e25691ab24632c14dea691..6c59a6a2a79851243fc635169057048b7f6bc9c3 100644 (file)
--- a/include/stdio.h
+++ b/include/stdio.h
@@ -1,22 +1,23 @@
 /*
 /*

- * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 2000, 2005, 2007 Apple Inc. All rights reserved.

  *
  * @APPLE_LICENSE_HEADER_START@
  *
  * @APPLE_LICENSE_HEADER_START@

- * 
- * The contents of this file constitute Original Code as defined in and
- * are subject to the Apple Public Source License Version 1.1 (the
- * "License").  You may not use this file except in compliance with the
- * License.  Please obtain a copy of the License at
- * http://www.apple.com/publicsource and read it before using this file.
- * 
- * This Original Code and all software distributed under the License are
- * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ *
+ * This file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this
+ * file.
+ *
+ * The Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER

  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,

- * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
- * License for the specific language governing rights and limitations
- * under the License.
- * 
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and
+ * limitations under the License.
+ *

  * @APPLE_LICENSE_HEADER_END@
  */
 /*-
  * @APPLE_LICENSE_HEADER_END@
  */
 /*-


@@ -60,40 +61,30 @@
 #ifndef        _STDIO_H_
 #define        _STDIO_H_
 
 #ifndef        _STDIO_H_
 #define        _STDIO_H_
 

-#if !defined(_ANSI_SOURCE) && !defined(__STRICT_ANSI__)
-#include <sys/types.h>
+#include <_types.h>
+
+#ifndef _VA_LIST
+#define _VA_LIST
+/* DO NOT REMOVE THIS COMMENT: fixincludes needs to see:
+ * __gnuc_va_list and include <stdarg.h> */
+typedef __darwin_va_list       va_list;

 #endif
 
 #endif
 

-#include <sys/cdefs.h>
+#ifndef        _OFF_T
+#define        _OFF_T
+typedef        __darwin_off_t          off_t;
+#endif

 
 

-#include <machine/ansi.h>
-#ifndef        _BSD_SIZE_T_DEFINED_
-#define        _BSD_SIZE_T_DEFINED_
-typedef        _BSD_SIZE_T_    size_t;
+#ifndef        _SIZE_T
+#define        _SIZE_T
+typedef        __darwin_size_t         size_t;

 #endif
 
 #ifndef NULL
 #endif
 
 #ifndef NULL

-#define        NULL    0
-#endif
+#define NULL __DARWIN_NULL
+#endif /* ! NULL */

 
 

-/*
- * This is fairly grotesque, but pure ANSI code must not inspect the
- * innards of an fpos_t anyway.  The library internally uses off_t,
- * which we assume is exactly as big as eight chars.  (When we switch
- * to gcc 2.4 we will use __attribute__ here.)
- *
- * WARNING: the alignment constraints on an off_t and the struct below
- * differ on (e.g.) the SPARC.  Hence, the placement of an fpos_t object
- * in a structure will change if fpos_t's are not aligned on 8-byte
- * boundaries.  THIS IS A CROCK, but for now there is no way around it.
- */
-#if !defined(_ANSI_SOURCE) && !defined(__STRICT_ANSI__)
-typedef off_t fpos_t;
-#else
-typedef struct __sfpos {
-       char    _pos[8];
-} fpos_t;
-#endif
+typedef __darwin_off_t         fpos_t;

 
 #define        _FSTDIO                 /* Define for new stdio with functions. */
 
 
 #define        _FSTDIO                 /* Define for new stdio with functions. */
 


@@ -105,10 +96,13 @@ typedef struct __sfpos {
 
 /* stdio buffers */
 struct __sbuf {
 
 /* stdio buffers */
 struct __sbuf {

-       unsigned char *_base;
-       int     _size;
+       unsigned char   *_base;
+       int             _size;

 };
 
 };
 

+/* hold a buncha junk that would grow the ABI */
+struct __sFILEX;
+

 /*
  * stdio state variables.
  *
 /*
  * stdio state variables.
  *


@@ -146,14 +140,14 @@ typedef   struct __sFILE {
 
        /* operations */
        void    *_cookie;       /* cookie passed to io functions */
 
        /* operations */
        void    *_cookie;       /* cookie passed to io functions */

-       int     (*_close) __P((void *));
-       int     (*_read)  __P((void *, char *, int));
-       fpos_t  (*_seek)  __P((void *, fpos_t, int));
-       int     (*_write) __P((void *, const char *, int));
+       int     (*_close)(void *);
+       int     (*_read) (void *, char *, int);
+       fpos_t  (*_seek) (void *, fpos_t, int);
+       int     (*_write)(void *, const char *, int);

 
        /* separate buffer for long sequences of ungetc() */
        struct  __sbuf _ub;     /* ungetc buffer */
 
        /* separate buffer for long sequences of ungetc() */
        struct  __sbuf _ub;     /* ungetc buffer */

-       unsigned char *_up;     /* saved _p when _p is doing ungetc data */
+       struct __sFILEX *_extra; /* additions to FILE to not break ABI */

        int     _ur;            /* saved _r when _r is counting ungetc data */
 
        /* tricks to meet minimum requirements even when malloc() fails */
        int     _ur;            /* saved _r when _r is counting ungetc data */
 
        /* tricks to meet minimum requirements even when malloc() fails */


@@ -169,7 +163,13 @@ typedef    struct __sFILE {
 } FILE;
 
 __BEGIN_DECLS
 } FILE;
 
 __BEGIN_DECLS

+#if __DARWIN_UNIX03
+extern FILE *__stdinp;
+extern FILE *__stdoutp;
+extern FILE *__stderrp;
+#else /* !__DARWIN_UNIX03 */

 extern FILE __sF[];
 extern FILE __sF[];

+#endif /* __DARWIN_UNIX03 */

 __END_DECLS
 
 #define        __SLBF  0x0001          /* line buffered */
 __END_DECLS
 
 #define        __SLBF  0x0001          /* line buffered */


@@ -188,6 +188,7 @@ __END_DECLS
 #define        __SOFF  0x1000          /* set iff _offset is in fact correct */
 #define        __SMOD  0x2000          /* true => fgetln modified _p text */
 #define __SALC  0x4000         /* allocate string space dynamically */
 #define        __SOFF  0x1000          /* set iff _offset is in fact correct */
 #define        __SMOD  0x2000          /* true => fgetln modified _p text */
 #define __SALC  0x4000         /* allocate string space dynamically */

+#define __SIGN  0x8000         /* ignore this file in _fwalk */

 
 /*
  * The following three definitions are for ANSI C, which took them
 
 /*
  * The following three definitions are for ANSI C, which took them


@@ -231,132 +232,183 @@ __END_DECLS
 #define        SEEK_END        2       /* set file offset to EOF plus offset */
 #endif
 
 #define        SEEK_END        2       /* set file offset to EOF plus offset */
 #endif
 

-#define        stdin   (&__sF[0])
-#define        stdout  (&__sF[1])
-#define        stderr  (&__sF[2])
+#if __DARWIN_UNIX03
+#define        stdin   __stdinp
+#define        stdout  __stdoutp
+#define        stderr  __stderrp
+#else /* !__DARWIN_UNIX03 */
+#define stdin  (&__sF[0])
+#define stdout (&__sF[1])
+#define stderr (&__sF[2])
+#endif /* __DARWIN_UNIX03 */

 
 /*
  * Functions defined in ANSI C standard.
  */
 __BEGIN_DECLS
 
 /*
  * Functions defined in ANSI C standard.
  */
 __BEGIN_DECLS

-void    clearerr __P((FILE *));
-int     fclose __P((FILE *));
-int     feof __P((FILE *));
-int     ferror __P((FILE *));
-int     fflush __P((FILE *));
-int     fgetc __P((FILE *));
-int     fgetpos __P((FILE *, fpos_t *));
-char   *fgets __P((char *, int, FILE *));
-FILE   *fopen __P((const char *, const char *));
-int     fprintf __P((FILE *, const char *, ...));
-int     fputc __P((int, FILE *));
-int     fputs __P((const char *, FILE *));
-size_t  fread __P((void *, size_t, size_t, FILE *));
-FILE   *freopen __P((const char *, const char *, FILE *));
-int     fscanf __P((FILE *, const char *, ...));
-int     fseek __P((FILE *, long, int));
-int     fsetpos __P((FILE *, const fpos_t *));
-long    ftell __P((FILE *));
-size_t  fwrite __P((const void *, size_t, size_t, FILE *));
-int     getc __P((FILE *));
-int     getchar __P((void));
-char   *gets __P((char *));
-#if !defined(_ANSI_SOURCE) && !defined(_POSIX_SOURCE)
+void    clearerr(FILE *);
+int     fclose(FILE *);
+int     feof(FILE *);
+int     ferror(FILE *);
+int     fflush(FILE *);
+int     fgetc(FILE *);
+int     fgetpos(FILE * __restrict, fpos_t *);
+char   *fgets(char * __restrict, int, FILE *);
+FILE   *fopen(const char * __restrict, const char * __restrict);
+int     fprintf(FILE * __restrict, const char * __restrict, ...) __DARWIN_LDBL_COMPAT(fprintf);
+int     fputc(int, FILE *);
+//Begin-Libc
+#ifndef LIBC_ALIAS_FPUTS
+//End-Libc
+int     fputs(const char * __restrict, FILE * __restrict) __DARWIN_ALIAS(fputs);
+//Begin-Libc
+#else /* LIBC_ALIAS_FPUTS */
+int     fputs(const char * __restrict, FILE * __restrict) LIBC_ALIAS(fputs);
+#endif /* !LIBC_ALIAS_FPUTS */
+//End-Libc
+size_t  fread(void * __restrict, size_t, size_t, FILE * __restrict);
+//Begin-Libc
+#ifndef LIBC_ALIAS_FREOPEN
+//End-Libc
+FILE   *freopen(const char * __restrict, const char * __restrict,
+           FILE * __restrict) __DARWIN_ALIAS(freopen);
+//Begin-Libc
+#else /* LIBC_ALIAS_FREOPEN */
+FILE   *freopen(const char * __restrict, const char * __restrict,
+           FILE * __restrict) LIBC_ALIAS(freopen);
+#endif /* !LIBC_ALIAS_FREOPEN */
+//End-Libc
+int     fscanf(FILE * __restrict, const char * __restrict, ...) __DARWIN_LDBL_COMPAT(fscanf);
+int     fseek(FILE *, long, int);
+int     fsetpos(FILE *, const fpos_t *);
+long    ftell(FILE *);
+//Begin-Libc
+#ifndef LIBC_ALIAS_FWRITE
+//End-Libc
+size_t  fwrite(const void * __restrict, size_t, size_t, FILE * __restrict) __DARWIN_ALIAS(fwrite);
+//Begin-Libc
+#else /* LIBC_ALIAS_FWRITE */
+size_t  fwrite(const void * __restrict, size_t, size_t, FILE * __restrict) LIBC_ALIAS(fwrite);
+#endif /* !LIBC_ALIAS_FWRITE */
+//End-Libc
+int     getc(FILE *);
+int     getchar(void);
+char   *gets(char *);
+#if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))

 extern __const int sys_nerr;           /* perror(3) external variables */
 extern __const char *__const sys_errlist[];
 #endif
 extern __const int sys_nerr;           /* perror(3) external variables */
 extern __const char *__const sys_errlist[];
 #endif

-void    perror __P((const char *));
-int     printf __P((const char *, ...));
-int     putc __P((int, FILE *));
-int     putchar __P((int));
-int     puts __P((const char *));
-int     remove __P((const char *));
-int     rename  __P((const char *, const char *));
-void    rewind __P((FILE *));
-int     scanf __P((const char *, ...));
-void    setbuf __P((FILE *, char *));
-int     setvbuf __P((FILE *, char *, int, size_t));
-int     sprintf __P((char *, const char *, ...));
-int     sscanf __P((const char *, const char *, ...));
-FILE   *tmpfile __P((void));
-char   *tmpnam __P((char *));
-int     ungetc __P((int, FILE *));
-int     vfprintf __P((FILE *, const char *, _BSD_VA_LIST_));
-int     vprintf __P((const char *, _BSD_VA_LIST_));
-int     vsprintf __P((char *, const char *, _BSD_VA_LIST_));
-int     asprintf __P((char **, const char *, ...));
-int     vasprintf __P((char **, const char *, _BSD_VA_LIST_));
+void    perror(const char *);
+int     printf(const char * __restrict, ...) __DARWIN_LDBL_COMPAT(printf);
+int     putc(int, FILE *);
+int     putchar(int);
+int     puts(const char *);
+int     remove(const char *);
+int     rename (const char *, const char *);
+void    rewind(FILE *);
+int     scanf(const char * __restrict, ...) __DARWIN_LDBL_COMPAT(scanf);
+void    setbuf(FILE * __restrict, char * __restrict);
+int     setvbuf(FILE * __restrict, char * __restrict, int, size_t);
+int     sprintf(char * __restrict, const char * __restrict, ...) __DARWIN_LDBL_COMPAT(sprintf);
+int     sscanf(const char * __restrict, const char * __restrict, ...) __DARWIN_LDBL_COMPAT(sscanf);
+FILE   *tmpfile(void);
+char   *tmpnam(char *);
+int     ungetc(int, FILE *);
+int     vfprintf(FILE * __restrict, const char * __restrict, va_list) __DARWIN_LDBL_COMPAT(vfprintf);
+int     vprintf(const char * __restrict, va_list) __DARWIN_LDBL_COMPAT(vprintf);
+int     vsprintf(char * __restrict, const char * __restrict, va_list) __DARWIN_LDBL_COMPAT(vsprintf);
+#if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
+int     asprintf(char **, const char *, ...) __DARWIN_LDBL_COMPAT(asprintf);
+int     vasprintf(char **, const char *, va_list) __DARWIN_LDBL_COMPAT(vasprintf);
+#endif

 __END_DECLS
 
 /*
  * Functions defined in POSIX 1003.1.
  */
 #ifndef _ANSI_SOURCE
 __END_DECLS
 
 /*
  * Functions defined in POSIX 1003.1.
  */
 #ifndef _ANSI_SOURCE

-#define        L_cuserid       9       /* size for cuserid(); UT_NAMESIZE + 1 */

 #define        L_ctermid       1024    /* size for ctermid(); PATH_MAX */
 
 __BEGIN_DECLS
 #define        L_ctermid       1024    /* size for ctermid(); PATH_MAX */
 
 __BEGIN_DECLS

-char   *ctermid __P((char *));
-FILE   *fdopen __P((int, const char *));
-int     fileno __P((FILE *));
-__END_DECLS
-#endif /* not ANSI */
-
-/*
- * Routines that are purely local.
- */
-#if !defined (_ANSI_SOURCE) && !defined(_POSIX_SOURCE)
-__BEGIN_DECLS
-char   *fgetln __P((FILE *, size_t *));
-int     fpurge __P((FILE *));
-int     fseeko __P((FILE *, fpos_t, int));
-fpos_t ftello __P((FILE *));
-int     getw __P((FILE *));
-int     pclose __P((FILE *));
-FILE   *popen __P((const char *, const char *));
-int     putw __P((int, FILE *));
-void    setbuffer __P((FILE *, char *, int));
-int     setlinebuf __P((FILE *));
-char   *tempnam __P((const char *, const char *));
-int     snprintf __P((char *, size_t, const char *, ...));
-int     vsnprintf __P((char *, size_t, const char *, _BSD_VA_LIST_));
-int     vscanf __P((const char *, _BSD_VA_LIST_));
-int     vsscanf __P((const char *, const char *, _BSD_VA_LIST_));
-FILE   *zopen __P((const char *, const char *, int));
+char   *ctermid(char *);
+#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
+char   *ctermid_r(char *);
+#endif /* not POSIX */
+FILE   *fdopen(int, const char *);
+#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
+char   *fgetln(FILE *, size_t *);
+#endif /* not POSIX */
+int     fileno(FILE *);
+void    flockfile(FILE *);
+#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
+__const char
+       *fmtcheck(const char *, const char *);
+int     fpurge(FILE *);
+#endif /* not POSIX */
+int     fseeko(FILE *, off_t, int);
+off_t   ftello(FILE *);
+int     ftrylockfile(FILE *);
+void    funlockfile(FILE *);
+int     getc_unlocked(FILE *);
+int     getchar_unlocked(void);
+#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
+int     getw(FILE *);
+#endif /* not POSIX */
+int     pclose(FILE *);
+FILE   *popen(const char *, const char *);
+int     putc_unlocked(int, FILE *);
+int     putchar_unlocked(int);
+#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
+int     putw(int, FILE *);
+void    setbuffer(FILE *, char *, int);
+int     setlinebuf(FILE *);
+#endif /* not POSIX */
+int     snprintf(char * __restrict, size_t, const char * __restrict, ...) __DARWIN_LDBL_COMPAT(snprintf);
+//Begin-Libc
+#ifndef LIBC_ALIAS_TEMPNAM
+//End-Libc
+char   *tempnam(const char *, const char *) __DARWIN_ALIAS(tempnam);
+//Begin-Libc
+#else /* LIBC_ALIAS_TEMPNAM */
+char   *tempnam(const char *, const char *) LIBC_ALIAS(tempnam);
+#endif /* !LIBC_ALIAS_TEMPNAM */
+//End-Libc
+int     vfscanf(FILE * __restrict, const char * __restrict, va_list) __DARWIN_LDBL_COMPAT(vfscanf);
+int     vscanf(const char * __restrict, va_list) __DARWIN_LDBL_COMPAT(vscanf);
+int     vsnprintf(char * __restrict, size_t, const char * __restrict, va_list) __DARWIN_LDBL_COMPAT(vsnprintf);
+int     vsscanf(const char * __restrict, const char * __restrict, va_list) __DARWIN_LDBL_COMPAT(vsscanf);
+#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
+FILE   *zopen(const char *, const char *, int);
+#endif /* not POSIX */

 __END_DECLS
 
 __END_DECLS
 

-/*
- * This is a #define because the function is used internally and
- * (unlike vfscanf) the name __svfscanf is guaranteed not to collide
- * with a user function when _ANSI_SOURCE or _POSIX_SOURCE is defined.
- */
-#define         vfscanf        __svfscanf
-

 /*
  * Stdio function-access interface.
  */
 /*
  * Stdio function-access interface.
  */

+#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)

 __BEGIN_DECLS
 __BEGIN_DECLS

-FILE   *funopen __P((const void *,
+FILE   *funopen(const void *,

                int (*)(void *, char *, int),
                int (*)(void *, const char *, int),
                fpos_t (*)(void *, fpos_t, int),
                int (*)(void *, char *, int),
                int (*)(void *, const char *, int),
                fpos_t (*)(void *, fpos_t, int),

-               int (*)(void *)));
+               int (*)(void *));

 __END_DECLS
 #define        fropen(cookie, fn) funopen(cookie, fn, 0, 0, 0)
 #define        fwopen(cookie, fn) funopen(cookie, 0, fn, 0, 0)
 __END_DECLS
 #define        fropen(cookie, fn) funopen(cookie, fn, 0, 0, 0)
 #define        fwopen(cookie, fn) funopen(cookie, 0, fn, 0, 0)

-#endif /* !_ANSI_SOURCE && !_POSIX_SOURCE */
+#endif /* not POSIX */
+#endif /* not ANSI */

 
 /*
  * Functions internal to the implementation.
  */
 __BEGIN_DECLS
 
 /*
  * Functions internal to the implementation.
  */
 __BEGIN_DECLS

-int    __srget __P((FILE *));
-int    __svfscanf __P((FILE *, const char *, _BSD_VA_LIST_));
-int    __swbuf __P((int, FILE *));
+int    __srget(FILE *);
+int    __svfscanf(FILE *, const char *, va_list) __DARWIN_LDBL_COMPAT(__svfscanf);
+int    __swbuf(int, FILE *);

 __END_DECLS
 
 /*
 __END_DECLS
 
 /*

- * The __sfoo macros are here so that we can 
+ * The __sfoo macros are here so that we can

  * define function versions in the C library.
  */
 #define        __sgetc(p) (--(p)->_r < 0 ? __srget(p) : (int)(*(p)->_p++))
  * define function versions in the C library.
  */
 #define        __sgetc(p) (--(p)->_r < 0 ? __srget(p) : (int)(*(p)->_p++))


@@ -386,19 +438,30 @@ static __inline int __sputc(int _c, FILE *_p) {
 #define        __sclearerr(p)  ((void)((p)->_flags &= ~(__SERR|__SEOF)))
 #define        __sfileno(p)    ((p)->_file)
 
 #define        __sclearerr(p)  ((void)((p)->_flags &= ~(__SERR|__SEOF)))
 #define        __sfileno(p)    ((p)->_file)
 

-#define        feof(p)         __sfeof(p)
-#define        ferror(p)       __sferror(p)
-#define        clearerr(p)     __sclearerr(p)
-

 #ifndef _ANSI_SOURCE
 #ifndef _ANSI_SOURCE

-#define        fileno(p)       __sfileno(p)
-#endif
+#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
+#define        feof_unlocked(p)        __sfeof(p)
+#define        ferror_unlocked(p)      __sferror(p)
+#define        clearerr_unlocked(p)    __sclearerr(p)
+#define        fileno_unlocked(p)      __sfileno(p)
+#endif /* not POSIX */

 
 #ifndef lint
 
 #ifndef lint

-#define        getc(fp)        __sgetc(fp)
-#define putc(x, fp)    __sputc(x, fp)
+#define        getc_unlocked(fp)       __sgetc(fp)
+#define putc_unlocked(x, fp)   __sputc(x, fp)

 #endif /* lint */
 
 #endif /* lint */
 

-#define        getchar()       getc(stdin)
-#define        putchar(x)      putc(x, stdout)
+#define        getchar_unlocked()      getc_unlocked(stdin)
+#define        putchar_unlocked(x)     putc_unlocked(x, stdout)
+#endif /* not ANSI */
+
+#ifdef _USE_EXTENDED_LOCALES_
+#include <xlocale/_stdio.h>
+#endif /* _USE_EXTENDED_LOCALES_ */
+
+#if defined (__GNUC__) && _FORTIFY_SOURCE > 0 && !defined (__cplusplus)
+/* Security checking functions.  */
+#include <secure/_stdio.h>
+#endif
+

 #endif /* _STDIO_H_ */
 #endif /* _STDIO_H_ */