xref: /plan9-contrib/sys/include/ape/stdio.h (revision 22df390c30710ddd2119f3e7bb6c92dc399cabb9)
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.
14*22df390cSDavid du Colombier  *
153e12c5d1SDavid du Colombier  * If rp<wp, we must have state==RD and
163e12c5d1SDavid du Colombier  * if wp<rp, we must have state==WR, so that getc and putc work correctly.
17*22df390cSDavid du Colombier  * On open, rp, wp and buf are set to 0, so first getc or putc will call
18*22df390cSDavid du Colombier  * _IO_getc or _IO_putc, which will allocate the buffer.
193e12c5d1SDavid du Colombier  * If setvbuf(., ., _IONBF, .) is called, bufl is set to 0 and
203e12c5d1SDavid du Colombier  * buf, rp and wp are pointed at unbuf.
21*22df390cSDavid du Colombier  * If setvbuf(., ., _IOLBF, .) is called, _IO_putc leaves wp and rp pointed at
22*22df390cSDavid du Colombier  * the end of the buffer so that it can be called on each putc to check whether
23*22df390cSDavid du Colombier  * it's got a newline.  This nonsense is in order to avoid impacting performance
24*22df390cSDavid du Colombier  * of the other buffering modes more than necessary -- putting the test in putc
25*22df390cSDavid du Colombier  * adds many instructions that are wasted in non-_IOLBF mode:
263e12c5d1SDavid du Colombier  * #define putc(c, f) (_IO_ctmp=(c),\
27*22df390cSDavid du Colombier  * 		(f)->wp>=(f)->rp || (f)->flags&LINEBUF && _IO_ctmp=='\n'?\
28*22df390cSDavid du Colombier  * 		_IO_putc(_IO_ctmp, f): *(f)->wp++=_IO_ctmp)
293e12c5d1SDavid du Colombier  */
303e12c5d1SDavid du Colombier typedef struct{
313e12c5d1SDavid du Colombier 	int fd;		/* UNIX file pointer */
323e12c5d1SDavid du Colombier 	char flags;	/* bits for must free buffer on close, line-buffered */
333e12c5d1SDavid du Colombier 	char state;	/* last operation was read, write, position, error, eof */
34*22df390cSDavid du Colombier 	unsigned char *buf;	/* pointer to i/o buffer */
35*22df390cSDavid du Colombier 	unsigned char *rp;	/* read pointer (or write end-of-buffer) */
36*22df390cSDavid du Colombier 	unsigned char *wp;	/* write pointer (or read end-of-buffer) */
37*22df390cSDavid du Colombier 	unsigned char *lp;	/* actual write pointer used when line-buffering */
383e12c5d1SDavid du Colombier 	size_t bufl;	/* actual length of buffer */
39*22df390cSDavid du Colombier 	unsigned char unbuf[1];	/* tiny buffer for unbuffered io (used for ungetc?) */
40*22df390cSDavid du Colombier 	int	junk;
413e12c5d1SDavid du Colombier }FILE;
42*22df390cSDavid du Colombier 
43*22df390cSDavid du Colombier typedef off_t fpos_t;
44*22df390cSDavid du Colombier 
453e12c5d1SDavid du Colombier #ifndef NULL
46f19e7b74SDavid du Colombier #ifdef __cplusplus
473e12c5d1SDavid du Colombier #define NULL 0
48f19e7b74SDavid du Colombier #else
49f19e7b74SDavid du Colombier #define NULL ((void*)0)
50f19e7b74SDavid du Colombier #endif
513e12c5d1SDavid du Colombier #endif
52*22df390cSDavid du Colombier 
533e12c5d1SDavid du Colombier /*
543e12c5d1SDavid du Colombier  * Third arg of setvbuf
553e12c5d1SDavid du Colombier  */
563e12c5d1SDavid du Colombier #define	_IOFBF	1			/* block-buffered */
573e12c5d1SDavid du Colombier #define	_IOLBF	2			/* line-buffered */
583e12c5d1SDavid du Colombier #define	_IONBF	3			/* unbuffered */
59*22df390cSDavid du Colombier 
60*22df390cSDavid du Colombier #define	BUFSIZ	8192			/* size of setbuf buffer */
613e12c5d1SDavid du Colombier #define	EOF	(-1)			/* returned on end of file */
62*22df390cSDavid du Colombier #define	FOPEN_MAX	128		/* max files open */
633e12c5d1SDavid du Colombier #define	FILENAME_MAX	BUFSIZ		/* silly filename length */
643e12c5d1SDavid du Colombier #define	L_tmpnam	20		/* sizeof "/tmp/abcdefghij9999 */
653e12c5d1SDavid du Colombier #define	L_cuserid	32		/* maximum size user name */
663e12c5d1SDavid du Colombier #define	L_ctermid	32		/* size of name of controlling tty */
67*22df390cSDavid du Colombier 
68*22df390cSDavid du Colombier #ifndef SEEK_SET			/* also defined in unistd.h */
693e12c5d1SDavid du Colombier #define	SEEK_CUR	1
703e12c5d1SDavid du Colombier #define	SEEK_END	2
713e12c5d1SDavid du Colombier #define	SEEK_SET	0
72*22df390cSDavid du Colombier #endif
733e12c5d1SDavid du Colombier #define	TMP_MAX		64		/* very hard to set correctly */
74*22df390cSDavid du Colombier 
753e12c5d1SDavid du Colombier #define	stderr	(&_IO_stream[2])
763e12c5d1SDavid du Colombier #define	stdin	(&_IO_stream[0])
773e12c5d1SDavid du Colombier #define	stdout	(&_IO_stream[1])
78*22df390cSDavid du Colombier 
79*22df390cSDavid du Colombier extern FILE _IO_stream[FOPEN_MAX];
803e12c5d1SDavid du Colombier 
813e12c5d1SDavid du Colombier #ifdef __cplusplus
823e12c5d1SDavid du Colombier extern "C" {
833e12c5d1SDavid du Colombier #endif
843e12c5d1SDavid du Colombier 
85*22df390cSDavid du Colombier int	_IO_getc(FILE *f);
86*22df390cSDavid du Colombier int	_IO_putc(int, FILE *);
87*22df390cSDavid du Colombier void	clearerr(FILE *);
88*22df390cSDavid du Colombier int	fclose(FILE *);
89*22df390cSDavid du Colombier FILE	*fdopen(const int, const char *);
90*22df390cSDavid du Colombier int	feof(FILE *);
91*22df390cSDavid du Colombier int	ferror(FILE *);
92*22df390cSDavid du Colombier int	fflush(FILE *);
93*22df390cSDavid du Colombier int	fgetc(FILE *);
94*22df390cSDavid du Colombier int	fgetpos(FILE *, fpos_t *);
95*22df390cSDavid du Colombier char	*fgets(char *, int, FILE *);
96*22df390cSDavid du Colombier int	fileno(FILE *);
97*22df390cSDavid du Colombier FILE	*fopen(const char *, const char *);
98*22df390cSDavid du Colombier int	fprintf(FILE *, const char *, ...);
99*22df390cSDavid du Colombier int	fputc(int, FILE *);
100*22df390cSDavid du Colombier int	fputs(const char *, FILE *);
101*22df390cSDavid du Colombier size_t	fread(void *, size_t, size_t, FILE *);
102*22df390cSDavid du Colombier FILE	*freopen(const char *, const char *, FILE *);
103*22df390cSDavid du Colombier int	fscanf(FILE *, const char *, ...);
104*22df390cSDavid du Colombier int	fseek(FILE *, long, int);
105*22df390cSDavid du Colombier int	fseeko(FILE *, off_t, int);
106*22df390cSDavid du Colombier int	fsetpos(FILE *, const fpos_t *);
107*22df390cSDavid du Colombier long	ftell(FILE *);
108*22df390cSDavid du Colombier off_t	ftello(FILE *);
109*22df390cSDavid du Colombier size_t	fwrite(const void *, size_t, size_t, FILE *);
110*22df390cSDavid du Colombier int	getc(FILE *);
111*22df390cSDavid du Colombier #define	getc(f)	((f)->rp>=(f)->wp? _IO_getc(f): *(f)->rp++)
112*22df390cSDavid du Colombier int	getchar(void);
113*22df390cSDavid du Colombier #define	getchar()	getc(stdin)
114*22df390cSDavid du Colombier char	*gets(char *);
115*22df390cSDavid du Colombier void	perror(const char *);
116*22df390cSDavid du Colombier int	printf(const char *, ...);
117*22df390cSDavid du Colombier int	putc(int, FILE *);
118*22df390cSDavid du Colombier /* assignment to f->junk eliminates warnings about unused result of operation */
119*22df390cSDavid du Colombier #define	putc(c, f) ((f)->junk = ((f)->wp>=(f)->rp? \
120*22df390cSDavid du Colombier 	_IO_putc(c, f): (*(f)->wp++ = (c))))
121*22df390cSDavid du Colombier int	putchar(int);
122*22df390cSDavid du Colombier #define	putchar(c)	putc(c, stdout)
123*22df390cSDavid du Colombier int	puts(const char *);
124*22df390cSDavid du Colombier int	remove(const char *);
125*22df390cSDavid du Colombier int	rename(const char *, const char *);
126*22df390cSDavid du Colombier void	rewind(FILE *);
127*22df390cSDavid du Colombier int	scanf(const char *, ...);
128*22df390cSDavid du Colombier void	setbuf(FILE *, char *);
129*22df390cSDavid du Colombier int	setvbuf(FILE *, char *, int, size_t);
130781103c4SDavid du Colombier /*
131*22df390cSDavid du Colombier  * NB: C99 now requires *snprintf to return the number of characters
132781103c4SDavid du Colombier  * that would have been written, had there been room.
133781103c4SDavid du Colombier  */
134*22df390cSDavid du Colombier int	snprintf(char *, size_t, const char *, ...);
135*22df390cSDavid du Colombier int	sprintf(char *, const char *, ...);
136*22df390cSDavid du Colombier int	sscanf(const char *, const char *, ...);
137*22df390cSDavid du Colombier FILE	*tmpfile(void);
138*22df390cSDavid du Colombier char	*tmpnam(char *);
139*22df390cSDavid du Colombier int	ungetc(int, FILE *);
140*22df390cSDavid du Colombier int	vfprintf(FILE *, const char *, va_list);
141*22df390cSDavid du Colombier int	vfscanf(FILE *, const char *, va_list);
142*22df390cSDavid du Colombier int	vprintf(const char *, va_list);
143*22df390cSDavid du Colombier int	vsnprintf(char *, size_t, const char *, va_list);
144*22df390cSDavid du Colombier int	vsprintf(char *, const char *, va_list);
1453e12c5d1SDavid du Colombier 
1463e12c5d1SDavid du Colombier #ifdef _POSIX_SOURCE
147*22df390cSDavid du Colombier int	fileno(FILE *);
148*22df390cSDavid du Colombier FILE*	fdopen(int, const char*);
149*22df390cSDavid du Colombier char	*ctermid(char *);
1503e12c5d1SDavid du Colombier #endif
1513e12c5d1SDavid du Colombier 
1522d069feaSDavid du Colombier #ifdef _REENTRANT_SOURCE
153*22df390cSDavid du Colombier char	*tmpnam_r(char *);
154*22df390cSDavid du Colombier char	*ctermid_r(char *);
1552d069feaSDavid du Colombier #endif
1562d069feaSDavid du Colombier 
157219b2ee8SDavid du Colombier #ifdef _BSD_EXTENSION
158219b2ee8SDavid du Colombier #pragma lib "/$M/lib/ape/libbsd.a"
159*22df390cSDavid du Colombier FILE	*popen(char *, char *);
160*22df390cSDavid du Colombier int	pclose(FILE	*);
161219b2ee8SDavid du Colombier #endif
162219b2ee8SDavid du Colombier 
1633e12c5d1SDavid du Colombier #ifdef __cplusplus
1643e12c5d1SDavid du Colombier }
1653e12c5d1SDavid du Colombier #endif
1663e12c5d1SDavid du Colombier 
1673e12c5d1SDavid du Colombier #endif
168