xref: /plan9/sys/include/stdio.h (revision f19e7b749ec99577072cd8e44030fe810f42c7ad)
1219b2ee8SDavid du Colombier #pragma	src	"/sys/src/libstdio"
23e12c5d1SDavid du Colombier #pragma	lib	"libstdio.a"
33e12c5d1SDavid du Colombier 
43e12c5d1SDavid du Colombier /*
53e12c5d1SDavid du Colombier  * pANS astdio.h
63e12c5d1SDavid du Colombier  */
73e12c5d1SDavid du Colombier /*
83e12c5d1SDavid du Colombier  * According to X3J11, there is only one i/o buffer
93e12c5d1SDavid du Colombier  * and it must not be occupied by both input and output data.
103e12c5d1SDavid du Colombier  *	If rp<wp, we must have state==RD and
113e12c5d1SDavid du Colombier  *	if wp<rp, we must have state==WR, so that getc and putc work correctly.
123e12c5d1SDavid du Colombier  *	On open, rp, wp and buf are set to 0, so first getc or putc will call _IO_getc
133e12c5d1SDavid du Colombier  *	or _IO_putc, which will allocate the buffer.
143e12c5d1SDavid du Colombier  *	If setvbuf(., ., _IONBF, .) is called, bufl is set to 0 and
153e12c5d1SDavid du Colombier  *	buf, rp and wp are pointed at unbuf.
163e12c5d1SDavid du Colombier  *	If setvbuf(., ., _IOLBF, .) is called, _IO_putc leaves wp and rp pointed at the
173e12c5d1SDavid du Colombier  *	end of the buffer so that it can be called on each putc to check whether it's got
183e12c5d1SDavid du Colombier  *	a newline.  This nonsense is in order to avoid impacting performance of the other
193e12c5d1SDavid du Colombier  *	buffering modes more than necessary -- putting the test in putc adds many
203e12c5d1SDavid du Colombier  *	instructions that are wasted in non-_IOLBF mode:
213e12c5d1SDavid du Colombier  *	#define putc(c, f)	(_IO_ctmp=(c),\
223e12c5d1SDavid du Colombier  *				(f)->wp>=(f)->rp || (f)->flags&LINEBUF && _IO_ctmp=='\n'\
233e12c5d1SDavid du Colombier  *					?_IO_putc(_IO_ctmp, f)\
243e12c5d1SDavid du Colombier  *					:*(f)->wp++=_IO_ctmp)
253e12c5d1SDavid du Colombier  *
263e12c5d1SDavid du Colombier  */
273e12c5d1SDavid du Colombier typedef struct{
283e12c5d1SDavid du Colombier 	int fd;		/* UNIX file pointer */
293e12c5d1SDavid du Colombier 	char flags;	/* bits for must free buffer on close, line-buffered */
303e12c5d1SDavid du Colombier 	char state;	/* last operation was read, write, position, error, eof */
313e12c5d1SDavid du Colombier 	char *buf;	/* pointer to i/o buffer */
323e12c5d1SDavid du Colombier 	char *rp;	/* read pointer (or write end-of-buffer) */
333e12c5d1SDavid du Colombier 	char *wp;	/* write pointer (or read end-of-buffer) */
343e12c5d1SDavid du Colombier 	char *lp;	/* actual write pointer used when line-buffering */
353e12c5d1SDavid du Colombier 	long bufl;	/* actual length of buffer */
363e12c5d1SDavid du Colombier 	char unbuf[1];	/* tiny buffer for unbuffered io (used for ungetc?) */
373e12c5d1SDavid du Colombier }FILE;
383e12c5d1SDavid du Colombier typedef long fpos_t;
393e12c5d1SDavid du Colombier #ifndef NULL
40*f19e7b74SDavid du Colombier #define	NULL	((void*)0)
413e12c5d1SDavid du Colombier #endif
423e12c5d1SDavid du Colombier /*
433e12c5d1SDavid du Colombier  * Third arg of setvbuf
443e12c5d1SDavid du Colombier  */
453e12c5d1SDavid du Colombier #define	_IOFBF	1			/* block-buffered */
463e12c5d1SDavid du Colombier #define	_IOLBF	2			/* line-buffered */
473e12c5d1SDavid du Colombier #define	_IONBF	3			/* unbuffered */
483e12c5d1SDavid du Colombier #define	BUFSIZ	4096			/* size of setbuf buffer */
493e12c5d1SDavid du Colombier #define	EOF	(-1)			/* returned on end of file */
503e12c5d1SDavid du Colombier #define	FOPEN_MAX	100		/* max files open */
513e12c5d1SDavid du Colombier #define	FILENAME_MAX	BUFSIZ		/* silly filename length */
523e12c5d1SDavid du Colombier #define	L_tmpnam	20		/* sizeof "/tmp/abcdefghij9999 */
537dd7cddfSDavid du Colombier #ifndef SEEK_SET			/* also defined in unistd.h */
543e12c5d1SDavid du Colombier #define	SEEK_CUR	1
553e12c5d1SDavid du Colombier #define	SEEK_END	2
563e12c5d1SDavid du Colombier #define	SEEK_SET	0
577dd7cddfSDavid du Colombier #endif
583e12c5d1SDavid du Colombier #define	TMP_MAX		64		/* very hard to set correctly */
593e12c5d1SDavid du Colombier #define	stderr	(&_IO_stream[2])
603e12c5d1SDavid du Colombier #define	stdin	(&_IO_stream[0])
613e12c5d1SDavid du Colombier #define	stdout	(&_IO_stream[1])
623e12c5d1SDavid du Colombier #define	_IO_CHMASK	0377		/* mask for 8 bit characters */
633e12c5d1SDavid du Colombier FILE *tmpfile(void);
643e12c5d1SDavid du Colombier char *tmpnam(char *);
653e12c5d1SDavid du Colombier int fclose(FILE *);
663e12c5d1SDavid du Colombier int fflush(FILE *);
673e12c5d1SDavid du Colombier FILE *fopen(const char *, const char *);
683e12c5d1SDavid du Colombier FILE *fdopen(const int, const char *);
693e12c5d1SDavid du Colombier FILE *freopen(const char *, const char *, FILE *);
703e12c5d1SDavid du Colombier void setbuf(FILE *, char *);
713e12c5d1SDavid du Colombier int setvbuf(FILE *, char *, int, long);
723e12c5d1SDavid du Colombier int fprintf(FILE *, const char *, ...);
733e12c5d1SDavid du Colombier int fscanf(FILE *, const char *, ...);
743e12c5d1SDavid du Colombier int printf(const char *, ...);
753e12c5d1SDavid du Colombier int scanf(const char *, ...);
763e12c5d1SDavid du Colombier int sprintf(char *, const char *, ...);
7780ee5cbfSDavid du Colombier int snprintf(char *, int, const char *, ...);
783e12c5d1SDavid du Colombier int sscanf(const char *, const char *, ...);
7980ee5cbfSDavid du Colombier int vfprintf(FILE *, const char *, va_list);
8080ee5cbfSDavid du Colombier int vprintf(const char *, va_list);
8180ee5cbfSDavid du Colombier int vsprintf(char *, const char *, va_list);
8280ee5cbfSDavid du Colombier int vsnprintf(char *, int, const char *, va_list);
8380ee5cbfSDavid du Colombier int vfscanf(FILE *, const char *, va_list);
843e12c5d1SDavid du Colombier int fgetc(FILE *);
853e12c5d1SDavid du Colombier char *fgets(char *, int, FILE *);
863e12c5d1SDavid du Colombier int fputc(int, FILE *);
873e12c5d1SDavid du Colombier int fputs(const char *, FILE *);
883e12c5d1SDavid du Colombier int getc(FILE *);
893e12c5d1SDavid du Colombier #define	getc(f)	((f)->rp>=(f)->wp?_IO_getc(f):*(f)->rp++&_IO_CHMASK)
903e12c5d1SDavid du Colombier int _IO_getc(FILE *f);
913e12c5d1SDavid du Colombier int getchar(void);
923e12c5d1SDavid du Colombier #define	getchar()	getc(stdin)
933e12c5d1SDavid du Colombier char *gets(char *);
943e12c5d1SDavid du Colombier int putc(int, FILE *);
953e12c5d1SDavid du Colombier #define	putc(c, f) ((f)->wp>=(f)->rp?_IO_putc(c, f):(*(f)->wp++=c)&_IO_CHMASK)
963e12c5d1SDavid du Colombier int _IO_putc(int, FILE *);
973e12c5d1SDavid du Colombier int putchar(int);
983e12c5d1SDavid du Colombier #define	putchar(c)	putc(c, stdout)
993e12c5d1SDavid du Colombier int puts(const char *);
1003e12c5d1SDavid du Colombier int ungetc(int, FILE *);
1013e12c5d1SDavid du Colombier long fread(void *, long, long, FILE *);
1023e12c5d1SDavid du Colombier long fwrite(const void *, long, long, FILE *);
1033e12c5d1SDavid du Colombier int fgetpos(FILE *, fpos_t *);
104dc5a79c1SDavid du Colombier int fseek(FILE *, long, int);
105dc5a79c1SDavid du Colombier int fseeko(FILE *, long long, int);
1063e12c5d1SDavid du Colombier int fsetpos(FILE *, const fpos_t *);
107dc5a79c1SDavid du Colombier long ftell(FILE *);
108dc5a79c1SDavid du Colombier long long ftello(FILE *);
1093e12c5d1SDavid du Colombier void rewind(FILE *);
1103e12c5d1SDavid du Colombier void clearerr(FILE *);
1113e12c5d1SDavid du Colombier int feof(FILE *);
1123e12c5d1SDavid du Colombier int ferror(FILE *);
1133e12c5d1SDavid du Colombier void perror(const char *);
1143e12c5d1SDavid du Colombier extern FILE _IO_stream[FOPEN_MAX];
1153e12c5d1SDavid du Colombier FILE *sopenr(const char *);
1163e12c5d1SDavid du Colombier FILE *sopenw(void);
1173e12c5d1SDavid du Colombier char *sclose(FILE *);
1183e12c5d1SDavid du Colombier int fileno(FILE *);
119