home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c1 / clib / !clib / h / stdio < prev    next >
Encoding:
Text File  |  1997-06-21  |  10.3 KB  |  313 lines
  1. /* stdio.h
  2.  
  3.    For use with the GNU compilers and the SharedCLibrary.
  4.    (c) Copyright 1997, Nick Burrett.  */
  5.  
  6. #ifndef __STDIO_H
  7. #define __STDIO_H
  8.  
  9. #ifndef __STDDEF_H
  10. #include <stddef.h>
  11. #endif
  12.  
  13. #ifdef __GNUC__
  14. #define __need___va_list
  15. #include <stdarg.h>
  16. #else
  17. /* Insert a definition of __va_list for your compiler here.
  18.    Copy the definition of 'va_list' in <stddef.h> but prefix it
  19.    with two underscores.  Then commend out the #error line below.  */
  20. #error need definition of __va_list for your compiler
  21. #endif
  22.  
  23. #ifdef __cplusplus
  24. extern "C" {
  25. #endif
  26.  
  27. #define __LIB_VERSION 300
  28.  
  29. typedef struct __fpos_t_struct
  30. {
  31.   unsigned long __lo;
  32. } fpos_t;
  33.  
  34. typedef struct __FILE_struct
  35. {
  36.   unsigned char *__ptr;
  37.   int __icnt;
  38.   int __ocnt;
  39.   int __flag;
  40.   unsigned char *__base;
  41.   void *__file;
  42.   long __pos;
  43.   int __bufsiz;
  44.   int __signature;
  45.   int *internal;
  46. } FILE;
  47.  
  48. #define _IOEOF 0x40
  49. #define _IOERR 0x80
  50. /* Full buffering.  */
  51. #define _IOFBF 0x100
  52. /* Line buffering.  */
  53. #define _IOLBF 0x200
  54. /* No buffering.  */
  55. #define _IONBF 0x400
  56. /* Default buffer size.  */
  57. #define BUFSIZ (4096)
  58. /* End of file character.  */
  59. #define EOF (-1)
  60.  
  61. /* Maximum number of files that can be open at once.  */
  62. #define FOPEN_MAX 8
  63. /* Number of open files that is imposed by this library.  */
  64. #define _SYS_OPEN 16
  65.  
  66. /* Maximum length of a filename.  */
  67. #define FILENAME_MAX 80
  68.  
  69.  
  70. /* Seek from beginning of file.  */
  71. #ifndef SEEK_SET
  72. #define SEEK_SET 0
  73. #endif
  74. /* Seek from current position.  */
  75. #ifndef SEEK_CUR
  76. #define SEEK_CUR 1
  77. #endif
  78. /* Seek from end of file.  */
  79. #ifndef SEEK_END
  80. #define SEEK_END 2
  81. #endif
  82.  
  83. /* How long an array of chars must be to be passed to tmpnam.  */
  84. #define L_tmpnam 20
  85. /* The maximum number of unique filenames generated by tmpnam.  */
  86. #define TMP_MAX 1000000000
  87.  
  88. /* Standard streams.  */
  89. extern FILE __iob[];
  90.  
  91. #define stdin (&__iob[0])
  92. #define stdout (&__iob[1])
  93. #define stderr (&__iob[2])
  94.  
  95. /* Delete file 'filename'.  */
  96. extern int remove (const char *filename);
  97.  
  98. /* Rename a file called 'oldname' to 'newname'. If rename fails
  99.    it returns -1.  */
  100. extern int rename (const char *oldname, const char *newname);
  101.  
  102. /* Create a temporary binary file for updade mode, as if calling
  103.    fopen with mode "wb+".  The file is deleted automatically when
  104.    it is closed or when the program terminates.  */
  105. extern FILE *tmpfile (void);
  106.  
  107. /* Construct and return a file name that is a valid and does not
  108.    name any existing file. If 'result' is null, the return value
  109.    points to an internal static string. Otherwise, 'result' points
  110.    to an array of at least L_tmpnam chars.  */
  111. extern char *tmpnam (char *result);
  112.  
  113. /* Cause 'stream' to be closed and the connection to the corresponding
  114.    file to be broken.  All buffered output is written and buffered
  115.    input is discarded. Returns 0 on success, EOF if an error was detected.  */
  116. extern int fclose (FILE *stream);
  117.  
  118. /* Cause any buffered output on 'stream' to be delivered to the file.
  119.    If 'stream' is null, then fflush causes buffered output on all open
  120.    output streams. Returns EOF if a write error occurs, zero otherwise.  */
  121. extern int fflush (FILE *stream);
  122.  
  123. /* Open a stream for I/O to the file 'filename' and return a pointer
  124.    to the stream.  */
  125. extern FILE *fopen (const char *filename, const char *opentype);
  126.  
  127. /* Close the stream 'stream', ignoring any errors. Then 'filename'
  128.    is opened with 'opentype' with the same stream object 'stream'.
  129.    Returns null on failure.  Usually used to connect to standard
  130.    streams e.g. stdin, stdout or stderr.  */
  131. extern FILE *freopen (const char *filename, const char *opentype, FILE *stream);
  132.  
  133. /* Set file buffering for 'stream'. If 'buf' is null, then
  134.    file buffering is turned off, otherwise we use full file buffering.  */
  135. extern void setbuf (FILE *stream, char *buf);
  136.  
  137. /* Specify that the stream 'stream' should have the buffering mode
  138.    'mode', which can be either _IOFBF (full buffering), _IOLBF (line
  139.    buffering) or _IONBF (unbuffered input/output).
  140.  
  141.    If 'buf' is null, then setvbuf allocates a buffer itself using
  142.    malloc. This is freed when the stream is closed.
  143.  
  144.    Otherwise 'buf' is a character array of 'size' characters.  */
  145. extern int setvbuf (FILE *stream, char *buf, int mode, size_t size);
  146.  
  147. /* Print the optional arguments under control of the template
  148.    string 'fmt' to the stream stdout. Returns the number of characters
  149.    printed, or a negative value if there was an output error.  */
  150. extern int printf (const char *fmt, ...);
  151.  
  152. /* Similar to printf except the output is written to the stream
  153.    'stream' instead of stdout.  */
  154. extern int fprintf (FILE *stream, const char *fmt, ...);
  155.  
  156. /* Similar to printf except the output is stored in the array
  157.    'string'. A null terminating character is also written.  */
  158. extern int sprintf (char *string, const char *fmt, ...);
  159.  
  160. /* Read formatted input from the stream stdin under control
  161.    of the template 'fmt'. Returns the number of successful
  162.    assignments.  */
  163. extern int scanf (const char *fmt, ...);
  164.  
  165. /* Similar to scanf but reads from the stream 'stream'.  */
  166. extern int fscanf (FILE *stream, const char *fmt, ...);
  167.  
  168. /* Similar to scanf but reads from the array 'string'.  */
  169. extern int sscanf (const char *string, const char *fmt, ...);
  170.  
  171. /* Similar to printf but it takes an argument list pointer 'ap'
  172.    instead of a variable number of arguments directly.  */
  173. #ifdef __GNUC__
  174. extern int vprintf (const char *fmt, __gnuc_va_list ap);
  175. extern int __gcc_vprintf (const char *fmt, __gnuc_va_list *ap);
  176. #define vprintf(fmt,ap) (__gcc_vprintf(fmt, &ap))
  177. #else
  178. extern int vprintf (const char *fmt, __va_list ap);
  179. #endif
  180.  
  181. /* Similar to fprintf but it takes an argument list pointer 'ap'
  182.    instead of a variable number of arguments directly.  */
  183. #ifdef __GNUC__
  184. extern int vfprintf (FILE *stream, const char *fmt, __gnuc_va_list ap);
  185. extern int __gcc_vfprintf (FILE *stream, const char *fmt, __gnuc_va_list *ap);
  186. #define vfprintf(stream,fmt,ap) (__gcc_vfprintf(stream, fmt, &ap))
  187. #else
  188. extern int vfprintf (FILE *stream, const char *fmt, __va_list ap);
  189. #endif
  190.  
  191. /* Similar to sprintf but it takes an argument list pointer 'ap'
  192.    instead of a variable number of arguments directly.  */
  193. #ifdef __GNUC__
  194. extern int vsprintf (char *string, const char *fmt, __gnuc_va_list ap);
  195. extern int __gcc_vsprintf (char *string, const char *fmt, __gnuc_va_list *ap);
  196. #define vsprintf(string,fmt,ap) (__gcc_vsprintf(stream, fmt, &ap))
  197. #else
  198. extern int vsprintf (char *string, const char *fmt, __va_list ap);
  199. #endif
  200.  
  201. /* Read the next character as an unsigned char from the stream
  202.    'stream' and return its value, converted to an int.  EOF
  203.    is returned on read error/end-of-file.  */
  204. extern int fgetc (FILE *stream);
  205. extern int __filbuf (FILE *stream);
  206.  
  207. /* Similar to fgetc but implemented as a macro, so stream can be
  208.    evaluated more than once.  */
  209. extern int getc (FILE *stream);
  210. #define getc(p) \
  211.  (--((p)->__icnt) >= 0 ? *((p)->__ptr)++ : __filbuf(p))
  212.  
  213. /* Equivalent to getc with a stream of stdin.  */
  214. extern int getchar (void);
  215. #define getchar() getc(stdin)
  216.  
  217. /* Read chars from the stream 'stream' up to and including a
  218.    newline character and stores them in the string 's'. A null
  219.    character is added to mark the end of the string.  The number
  220.    of characters to read at most is 'count - 1'.  */
  221. extern char *fgets (char *s, int count, FILE *stream);
  222.  
  223. /* Read chars from the stream 'stdin' up to and including a
  224.    new line. The newline character is discarded.  */
  225. extern char *gets(char *s);
  226. extern int __flsbuf(int , FILE * );
  227.  
  228. /* Convert the character 'c' to type unsigned char and writes it
  229.    to stream 'stream'.  EOF is returned if an error occurs;
  230.    otherwise the character 'c' is returned.  */
  231. extern int putc (int c, FILE *stream);
  232.  
  233. #define putc(ch, p) \
  234.  (--((p)->__ocnt) >= 0 ? (*((p)->__ptr)++ = (ch)) : __flsbuf(ch,p))
  235.  
  236. extern int fputc (int c, FILE *stream);
  237.  
  238. /* Equivalent to putc with stdout as the value of the stream argument.  */
  239. extern int putchar (int ch);
  240. #define putchar(ch) putc(ch, stdout)
  241.  
  242.  
  243. /* Write the string 's' top the stream 'stream'. The terminating null
  244.    character is not written, and a newline character is not added, either.  */
  245. extern int fputs(const char *s, FILE *stream);
  246.  
  247. /* Write the string 's' to stdout.  */
  248. extern int puts (const char *s);
  249.  
  250. /* Pushes back the character 'c' onto the input stream 'stream'.
  251.    The next input from 'stream' will read 'c' before anything else.
  252.    If 'c' is EOF, ungetc does nothing and just returns EOF.  */
  253. extern int ungetc (int , FILE * );
  254.  
  255. /* Read up to 'count' objects of size 'size' into the array 'data',
  256.    from the stream 'stream'. Return the number of objects actually
  257.    read.  */
  258. extern size_t fread (void *data, size_t size, size_t count, FILE *stream);
  259.  
  260. /* Write up to 'count' objects of size 'size' from the array 'data',
  261.    to the stream 'stream'. The return value is normally 'count' if the
  262.    call succeeds.  */
  263. extern size_t fwrite (const void *data, size_t size, size_t count, FILE *stream);
  264.  
  265. /* Store the value of the file position indicator for the
  266.    stream 'stream' in the fpos_t object pointed to by 'position'.
  267.    fgetpos returns zero on success.  */
  268. extern int fgetpos(FILE *stream, fpos_t *position);
  269.  
  270. /* Change the file position of the stream 'stream'. 'whence'
  271.    must be one of the constants SEEK_SET, SEEK_CUR, SEEK_END,
  272.    to indicate the meaning of the relative 'offset'.  */
  273. extern int fseek(FILE *stream, long int offset, int whence);
  274.  
  275. /* Set the file position indicator for the stream 'stream' to the
  276.    position 'position', which must be set by a previous call to
  277.    fgetpos.  */
  278. extern int fsetpos(FILE *stream, const fpos_t *position);
  279.  
  280. /* Return the current file position of the stream 'stream'.
  281.    If a failure occurs, -1 is returned.  */
  282. extern long int ftell(FILE *stream);
  283.  
  284. /* Positions the stream 'stream' at the beginning of the file.
  285.    Equivalent to fseek (stream, 0, SEEK_SET).  */
  286. extern void rewind(FILE *stream);
  287.  
  288. /* Clears the end-of-file and error indicators for the stream
  289.    'stream'.  */
  290. extern void clearerr (FILE *stream);
  291.  
  292. /* Return nonzero if the end-of-file indicator for stream 'stream'
  293.    is set.  */
  294. extern int feof (FILE *stream);
  295. #define feof(stream) ((stream)->__flag & _IOEOF)
  296.  
  297. /* Return nonzero if the error indicator for the stream 'stream'
  298.    is set.  */
  299. extern int ferror (FILE *stream);
  300. #define ferror(stream) ((stream)->__flag & _IOERR)
  301.  
  302. /* Print an error message to the stream 'stderr'.
  303.  
  304.    If 'message' is null, the error message corresponding to
  305.    'errno' is printed.  */
  306. extern void perror (const char *message);
  307.  
  308. #ifdef __cplusplus
  309. }
  310. #endif
  311.  
  312. #endif
  313.