Return to getchr.3 CVS log

Up to [Research Unix] / researchv10dc / dist / man / v4 / man3

Annotation of researchv10dc/dist/man/v4/man3/getchr.3, revision 1.1.1.1

1.1       root        1: .th GETCHAR III 4/7/73
                      2: .sh NAME
                      3: getchar \*- read character
                      4: .sh SYNOPSIS
                      5: .ft B
                      6: getchar( )
                      7: .br
                      8: .ft R
                      9: .sh DESCRIPTION
                     10: .it Getchar
                     11: provides the simplest means of reading characters from
                     12: the standard input for C programs.
                     13: It returns successive characters until end-of-file,
                     14: when it returns ``\\0''.
                     15: .s3
                     16: Associated with this routine is an external variable
                     17: called \fIfin\fR, which is a structure containing
                     18: a buffer such as described under \fIgetc\fR (III).
                     19: .s3
                     20: Normally input via \fIgetchar\fR is unbuffered,
                     21: but if the file-descriptor (first) word of
                     22: .it fin
                     23: is non-zero,
                     24: .it getchar
                     25: calls
                     26: .it getc
                     27: with
                     28: .it fin
                     29: as
                     30: argument.
                     31: This means that
                     32: .s3
                     33:        fin = open(...)
                     34: .s3
                     35: makes
                     36: .it getchar
                     37: return (buffered) input from
                     38: the opened file; also
                     39: .s3
                     40:        fin = dup(0);
                     41: .s3
                     42: causes the standard input to be buffered.
                     43: .s3
                     44: Generally speaking,
                     45: .it getchar
                     46: should be used only for the simplest applications;
                     47: .it getc
                     48: is better when there are multiple input files.
                     49: .sh "SEE ALSO"
                     50: getc (III)
                     51: .sh DIAGNOSTICS
                     52: Null character returned on EOF or error.
                     53: .sh BUGS
                     54: \*-1 should be
                     55: returned on EOF; null is a legitimate character.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.