AT&T UNIX™PC Unix System V Users Manual - tenox

AT&T UNIX™PC Unix System V Users Manual - tenox AT&T UNIX™PC Unix System V Users Manual - tenox

01.01.2013 Views

�·. (

GETC ( 3S ) GETC ( 3S ) NAME getc, getchar, fgetc, getw - get character or word from stream SYNOPSIS #include int getc (stream) FILE •stream; int getchar () int fgetc (stream) FILE •stream; int getw (stream) FILE •stream; DESCRIPTION Getc returns the next character (i.e. byte) from the named input stream. It also moves the file pointer, if defined, ahead one character in stream. Getc is a macro and so cannot be used if a function is necessary; for example one cannot have a function pointer point to it. Getchar returns the next character from the standard input stream, stdin. As in the case of getc, get char is a macro. Fgetc performs the same function as getc, but is a genuine function. Fgetc runs more slowly than getc, but takes less space per invocation. Getw returns the next word (i.e. integer) from the named input stream. The size of a word varies from machine to machine. It returns the constant EOF upon end-of-file or error, but as that is a valid integer value, feof and ferror(3S) should be used to check the success of getw. Getw increments the associated file pointer, if defined, to point to the next word. Getw assumes no special alignment in the file. SEE ALSO fclose(3S), ferror(3S), fopen(3S), fread(3S), gets(3S), putc(3S), scanf(3S). DIAGNOSTICS These functions return the integer constant EOF at end-of-file or upon an error. BUGS Because it is implemented as a macro, getc treats incorrectly a stream argument with side effects. In particular, getc( •f++) doesn't work sensibly. Fgetc should be used instead. Because of possible differences in word length and byte ordering, files written using putw are machine-dependent, and may not be read using getw on a different processor. - 1 -

�·.<br />

(

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!