Annotation of researchv10dc/dist/man/v3/man3/getc.3, revision 1.1.1.1

1.1       root        1: .pa 1
                      2: .he 'GETC, GETW, FOPEN (III)'3/15/72'GETC, GETW, FOPEN (III)'
                      3: .ti 0
                      4: NAME           getw, getc, fopen  --  buffered input
                      5: .sp
                      6: .ti 0
                      7: SYNOPSIS       mov     $filename,r0
                      8: .br
                      9: jsr    r5,fopen; iobuf
                     10: 
                     11: jsr    r5,getc; iobuf
                     12: .br
                     13: (character in r0)
                     14: 
                     15: jsr    r5,getw; iobuf
                     16: .br
                     17: (word in r0)
                     18: .sp
                     19: .ti 0
                     20: DESCRIPTION    These routines are used to provide a buffered input
                     21: facility.
                     22: iobuf_____ is the address of a 518(10) byte buffer area whose
                     23: contents are maintained by these routines.  Its format is:
                     24: .sp
                     25: .nf
                     26: ioptr: .=.+2           / file descriptor
                     27:        .=.+2           / characters left in buffer
                     28:        .=.+2           / ptr to next character
                     29:        .=.+512.        / the buffer
                     30: .sp
                     31: .fi
                     32: fopen_____ may be called initially to open the file.  On return,
                     33: the error bit (c-bit) is set if the open failed.
                     34: If fopen_____ is never called, get___ will read from the standard
                     35: input file.
                     36: .sp
                     37: getc____ returns the next byte from the file in r0.  The
                     38: error bit is set on end of file or a read error.
                     39: .sp
                     40: getw____ returns the next word in r0.  getc____ and getw____
                     41: may be used alternately; there are no odd/even
                     42: problems.
                     43: .sp
                     44: iobuf_____ must be provided by the user; it must be on a word boundary.
                     45: 
                     46: To reuse the same buffer for another file, it is sufficient
                     47: to close the original file and call fopen_____ again.
                     48: .sp
                     49: .ti 0
                     50: FILES          kept in /lib/liba.a
                     51: .sp
                     52: .ti 0
                     53: SEE ALSO       open(II), read(II), putc(III)
                     54: .sp
                     55: .ti 0
                     56: DIAGNOSTICS    c-bit set on EOF or error
                     57: .sp
                     58: .ti 0
                     59: BUGS           --

unix.superglobalmegacorp.com

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