xref: /plan9/sys/include/ape/stdio.h (revision 781103c4074deb8af160e8a0da2742ba6b29dc2b)
13e12c5d1SDavid du Colombier #ifndef	_STDIO_H_
23e12c5d1SDavid du Colombier #define	_STDIO_H_
33e12c5d1SDavid du Colombier #pragma lib "/$M/lib/ape/libap.a"
43e12c5d1SDavid du Colombier 
53e12c5d1SDavid du Colombier /*
63e12c5d1SDavid du Colombier  * pANS stdio.h
73e12c5d1SDavid du Colombier  */
83e12c5d1SDavid du Colombier #include <stdarg.h>
93e12c5d1SDavid du Colombier #include <stddef.h>
10d9dc5dd1SDavid du Colombier #include <sys/types.h>
113e12c5d1SDavid du Colombier /*
123e12c5d1SDavid du Colombier  * According to X3J11, there is only one i/o buffer
133e12c5d1SDavid du Colombier  * and it must not be occupied by both input and output data.
143e12c5d1SDavid du Colombier  *	If rp<wp, we must have state==RD and
153e12c5d1SDavid du Colombier  *	if wp<rp, we must have state==WR, so that getc and putc work correctly.
163e12c5d1SDavid du Colombier  *	On open, rp, wp and buf are set to 0, so first getc or putc will call _IO_getc
173e12c5d1SDavid du Colombier  *	or _IO_putc, which will allocate the buffer.
183e12c5d1SDavid du Colombier  *	If setvbuf(., ., _IONBF, .) is called, bufl is set to 0 and
193e12c5d1SDavid du Colombier  *	buf, rp and wp are pointed at unbuf.
203e12c5d1SDavid du Colombier  *	If setvbuf(., ., _IOLBF, .) is called, _IO_putc leaves wp and rp pointed at the
213e12c5d1SDavid du Colombier  *	end of the buffer so that it can be called on each putc to check whether it's got
223e12c5d1SDavid du Colombier  *	a newline.  This nonsense is in order to avoid impacting performance of the other
233e12c5d1SDavid du Colombier  *	buffering modes more than necessary -- putting the test in putc adds many
243e12c5d1SDavid du Colombier  *	instructions that are wasted in non-_IOLBF mode:
253e12c5d1SDavid du Colombier  *	#define putc(c, f)	(_IO_ctmp=(c),\
263e12c5d1SDavid du Colombier  *				(f)->wp>=(f)->rp || (f)->flags&LINEBUF && _IO_ctmp=='\n'\
273e12c5d1SDavid du Colombier  *					?_IO_putc(_IO_ctmp, f)\
283e12c5d1SDavid du Colombier  *					:*(f)->wp++=_IO_ctmp)
293e12c5d1SDavid du Colombier  *
303e12c5d1SDavid du Colombier  */
313e12c5d1SDavid du Colombier typedef struct{
323e12c5d1SDavid du Colombier 	int fd;		/* UNIX file pointer */
333e12c5d1SDavid du Colombier 	char flags;	/* bits for must free buffer on close, line-buffered */
343e12c5d1SDavid du Colombier 	char state;	/* last operation was read, write, position, error, eof */
353e12c5d1SDavid du Colombier 	char *buf;	/* pointer to i/o buffer */
363e12c5d1SDavid du Colombier 	char *rp;	/* read pointer (or write end-of-buffer) */
373e12c5d1SDavid du Colombier 	char *wp;	/* write pointer (or read end-of-buffer) */
383e12c5d1SDavid du Colombier 	char *lp;	/* actual write pointer used when line-buffering */
393e12c5d1SDavid du Colombier 	size_t bufl;	/* actual length of buffer */
403e12c5d1SDavid du Colombier 	char unbuf[1];	/* tiny buffer for unbuffered io (used for ungetc?) */
413e12c5d1SDavid du Colombier }FILE;
42d9306527SDavid du Colombier typedef long long fpos_t;
433e12c5d1SDavid du Colombier #ifndef NULL
44f19e7b74SDavid du Colombier #ifdef __cplusplus
453e12c5d1SDavid du Colombier #define NULL 0
46f19e7b74SDavid du Colombier #else
47f19e7b74SDavid du Colombier #define NULL ((void*)0)
48f19e7b74SDavid du Colombier #endif
493e12c5d1SDavid du Colombier #endif
503e12c5d1SDavid du Colombier /*
513e12c5d1SDavid du Colombier  * Third arg of setvbuf
523e12c5d1SDavid du Colombier  */
533e12c5d1SDavid du Colombier #define	_IOFBF	1			/* block-buffered */
543e12c5d1SDavid du Colombier #define	_IOLBF	2			/* line-buffered */
553e12c5d1SDavid du Colombier #define	_IONBF	3			/* unbuffered */
563e12c5d1SDavid du Colombier #define	BUFSIZ	4096			/* size of setbuf buffer */
573e12c5d1SDavid du Colombier #define	EOF	(-1)			/* returned on end of file */
583e12c5d1SDavid du Colombier #define	FOPEN_MAX	90		/* max files open */
593e12c5d1SDavid du Colombier #define	FILENAME_MAX	BUFSIZ		/* silly filename length */
603e12c5d1SDavid du Colombier #define	L_tmpnam	20		/* sizeof "/tmp/abcdefghij9999 */
613e12c5d1SDavid du Colombier #define	L_cuserid	32		/* maximum size user name */
623e12c5d1SDavid du Colombier #define	L_ctermid	32		/* size of name of controlling tty */
633e12c5d1SDavid du Colombier #define	SEEK_CUR	1
643e12c5d1SDavid du Colombier #define	SEEK_END	2
653e12c5d1SDavid du Colombier #define	SEEK_SET	0
663e12c5d1SDavid du Colombier #define	TMP_MAX		64		/* very hard to set correctly */
673e12c5d1SDavid du Colombier #define	stderr	(&_IO_stream[2])
683e12c5d1SDavid du Colombier #define	stdin	(&_IO_stream[0])
693e12c5d1SDavid du Colombier #define	stdout	(&_IO_stream[1])
703e12c5d1SDavid du Colombier #define	_IO_CHMASK	0377		/* mask for 8 bit characters */
713e12c5d1SDavid du Colombier 
723e12c5d1SDavid du Colombier #ifdef __cplusplus
733e12c5d1SDavid du Colombier extern "C" {
743e12c5d1SDavid du Colombier #endif
753e12c5d1SDavid du Colombier 
763e12c5d1SDavid du Colombier extern int remove(const char *);
773e12c5d1SDavid du Colombier extern int rename(const char *, const char *);
783e12c5d1SDavid du Colombier extern FILE *tmpfile(void);
793e12c5d1SDavid du Colombier extern char *tmpnam(char *);
803e12c5d1SDavid du Colombier extern int fclose(FILE *);
813e12c5d1SDavid du Colombier extern int fflush(FILE *);
823e12c5d1SDavid du Colombier extern FILE *fopen(const char *, const char *);
833e12c5d1SDavid du Colombier extern FILE *freopen(const char *, const char *, FILE *);
843e12c5d1SDavid du Colombier extern void setbuf(FILE *, char *);
853e12c5d1SDavid du Colombier extern int setvbuf(FILE *, char *, int, size_t);
863e12c5d1SDavid du Colombier extern int fprintf(FILE *, const char *, ...);
873e12c5d1SDavid du Colombier extern int fscanf(FILE *, const char *, ...);
883e12c5d1SDavid du Colombier extern int printf(const char *, ...);
893e12c5d1SDavid du Colombier extern int scanf(const char *, ...);
903e12c5d1SDavid du Colombier extern int sprintf(char *, const char *, ...);
91*781103c4SDavid du Colombier 
92*781103c4SDavid du Colombier /*
93*781103c4SDavid du Colombier  * NB: C99 now *requires *snprintf to return the number of characters
94*781103c4SDavid du Colombier  * that would have been written, had there been room.
95*781103c4SDavid du Colombier  */
96d9dc5dd1SDavid du Colombier extern int snprintf(char *, size_t, const char *, ...);
9725fc6993SDavid du Colombier extern int vsnprintf(char *, size_t, const char *, va_list);
98*781103c4SDavid du Colombier 
993e12c5d1SDavid du Colombier extern int sscanf(const char *, const char *, ...);
1003e12c5d1SDavid du Colombier extern int vfprintf(FILE *, const char *, va_list);
1013e12c5d1SDavid du Colombier extern int vprintf(const char *, va_list);
1023e12c5d1SDavid du Colombier extern int vsprintf(char *, const char *, va_list);
1033e12c5d1SDavid du Colombier extern int vfscanf(FILE *, const char *, va_list);
1043e12c5d1SDavid du Colombier extern int fgetc(FILE *);
1053e12c5d1SDavid du Colombier extern char *fgets(char *, int, FILE *);
1063e12c5d1SDavid du Colombier extern int fputc(int, FILE *);
1073e12c5d1SDavid du Colombier extern int fputs(const char *, FILE *);
1083e12c5d1SDavid du Colombier extern int getc(FILE *);
1093e12c5d1SDavid du Colombier #define	getc(f)	((f)->rp>=(f)->wp?_IO_getc(f):*(f)->rp++&_IO_CHMASK)
1103e12c5d1SDavid du Colombier extern int _IO_getc(FILE *f);
1113e12c5d1SDavid du Colombier extern int getchar(void);
1123e12c5d1SDavid du Colombier #define	getchar()	getc(stdin)
1133e12c5d1SDavid du Colombier extern char *gets(char *);
1143e12c5d1SDavid du Colombier extern int putc(int, FILE *);
1153e12c5d1SDavid du Colombier #define	putc(c, f) ((f)->wp>=(f)->rp?_IO_putc(c, f):(*(f)->wp++=c)&_IO_CHMASK)
1163e12c5d1SDavid du Colombier extern int _IO_putc(int, FILE *);
1173e12c5d1SDavid du Colombier extern int putchar(int);
1183e12c5d1SDavid du Colombier #define	putchar(c)	putc(c, stdout)
1193e12c5d1SDavid du Colombier extern int puts(const char *);
1203e12c5d1SDavid du Colombier extern int ungetc(int, FILE *);
1213e12c5d1SDavid du Colombier extern size_t fread(void *, size_t, size_t, FILE *);
1223e12c5d1SDavid du Colombier extern size_t fwrite(const void *, size_t, size_t, FILE *);
1233e12c5d1SDavid du Colombier extern int fgetpos(FILE *, fpos_t *);
124d9dc5dd1SDavid du Colombier extern int fseek(FILE *, long, int);
125d9dc5dd1SDavid du Colombier extern int fseeko(FILE *, off_t, int);
1263e12c5d1SDavid du Colombier extern int fsetpos(FILE *, const fpos_t *);
127d9dc5dd1SDavid du Colombier extern long ftell(FILE *);
128d9dc5dd1SDavid du Colombier extern off_t ftello(FILE *);
1293e12c5d1SDavid du Colombier extern void rewind(FILE *);
1303e12c5d1SDavid du Colombier extern void clearerr(FILE *);
1313e12c5d1SDavid du Colombier extern int feof(FILE *);
1323e12c5d1SDavid du Colombier extern int ferror(FILE *);
1333e12c5d1SDavid du Colombier extern void perror(const char *);
1343e12c5d1SDavid du Colombier extern FILE _IO_stream[FOPEN_MAX];
1353e12c5d1SDavid du Colombier 
1363e12c5d1SDavid du Colombier #ifdef _POSIX_SOURCE
1373e12c5d1SDavid du Colombier extern int fileno(FILE *);
1383e12c5d1SDavid du Colombier extern FILE* fdopen(int, const char*);
1393e12c5d1SDavid du Colombier extern char *ctermid(char *);
1403e12c5d1SDavid du Colombier #endif
1413e12c5d1SDavid du Colombier 
1422d069feaSDavid du Colombier #ifdef _REENTRANT_SOURCE
1432d069feaSDavid du Colombier extern char *tmpnam_r(char *);
1442d069feaSDavid du Colombier extern char *ctermid_r(char *);
1452d069feaSDavid du Colombier #endif
1462d069feaSDavid du Colombier 
147219b2ee8SDavid du Colombier #ifdef _BSD_EXTENSION
148219b2ee8SDavid du Colombier #pragma lib "/$M/lib/ape/libbsd.a"
149219b2ee8SDavid du Colombier extern FILE *popen(char *, char *);
150219b2ee8SDavid du Colombier extern int	pclose(FILE *);
151219b2ee8SDavid du Colombier #endif
152219b2ee8SDavid du Colombier 
1533e12c5d1SDavid du Colombier #ifdef __cplusplus
1543e12c5d1SDavid du Colombier }
1553e12c5d1SDavid du Colombier #endif
1563e12c5d1SDavid du Colombier 
1573e12c5d1SDavid du Colombier #endif
158