getc_unlocked man page on BSDOS

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDOS logo
[printable version]

GETC(3)			    BSD Programmer's Manual		       GETC(3)

NAME
     fgetc, getc, getc_unlocked, getchar, getchar_unlocked, getw - get next
     character or word from input stream

SYNOPSIS
     #include <stdio.h>

     int
     fgetc(FILE *stream);

     int
     getc(FILE *stream);

     int
     getc_unlocked(FILE *stream);

     int
     getchar(void);

     int
     getchar_unlocked(void);

     int
     getw(FILE *stream);

DESCRIPTION
     The fgetc() function obtains the next input character (if present) from
     the stream pointed at by stream, or the next character pushed back on the
     stream via ungetc.

     The getc() function acts identically to fgetc().

     The getchar() function is equivalent to getc() with the argument stdin.

     The getw() function obtains the next int (if present) from the stream
     pointed at by stream.

     The getc_unlocked() and getchar_unlocked() are equivalent to getc() and
     getchar() respectively except that they are expanded in-line and are not
     implemented in a thread-safe manner.  They are intended for use with
     flockfile() and funlockfile() which provide thread-safe synchronization.

RETURN VALUES
     If successful, these routines return the next requested object from the
     stream. If the stream is at end-of-file or a read error occurs, the rou-
     tines return EOF. The routines feof(3) and ferror(3) must be used to dis-
     tinguish between end-of-file and error.  If an error occurs, the global
     variable errno is set to indicate the error.  The end-of-file condition
     is remembered, even on a terminal, and all subsequent attempts to read
     will return EOF until the condition is cleared with clearerr.

     Note that EOF is negative, while input characters returned by the getc()
     family of functions are first strained through the unsigned char type, so
     that EOF is distinct from all possible input characters.  Storing the re-
     turn value in a char variable will lose this distinction, however, and
     should therefore be done only after comparison against EOF.

SEE ALSO
     ferror(3),	 fread(3),  fopen(3),  putc(3),	 ungetc(3),  pthreads(3),
     flockfile(3),  funlockfile(3)

STANDARDS
     The fgetc(), getc() and getchar() functions conform to ANSI C X3.159-1989
     (``ANSI C '').

     The getc_unlocked and getchar_unlocked functions conform to IEEE
     Std1003.1c (``POSIX'').

BUGS
     Since EOF is a valid integer value, feof and ferror must be used to check
     for failure after calling getw().	The size and byte order of an int
     varies from one machine to another, and getw() is not recommended for
     portable applications.

BSDI BSD/OS			 June 4, 1993				     2
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net