*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> getchar (3)              
Title
Content
Arch
Section
 

GETC(3)

Contents


NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <stdio.h>

     int
     fgetc(FILE *stream);

     int
     getc(FILE *stream);

     int
     getchar(void);

     int
     getw(FILE *stream);

DESCRIPTION    [Toc]    [Back]

     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(3).

     The getc() function acts essentially identically to fgetc(),
but is a
     macro that expands in-line.

     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.

RETURN VALUES    [Toc]    [Back]

     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 routines
 return EOF.  The routines feof(3) and  ferror(3)  must
be used to
     distinguish  between end-of-file and error.  If an error occurs, the global
 variable errno is set to indicate the error.  The end-offile condition
  is  remembered, even on a terminal, and all subsequent
attempts to
     read will return EOF until the  condition  is  cleared  with
clearerr(3).

SEE ALSO    [Toc]    [Back]

      
      
     ferror(3), fopen(3), fread(3), putc(3), ungetc(3)

STANDARDS    [Toc]    [Back]

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

BUGS    [Toc]    [Back]

     Since EOF is a valid integer value,  feof(3)  and  ferror(3)
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.

OpenBSD      3.6                           June      4,      1993
[ Back ]
 Similar pages
Name OS Title
getchar_unlocked Tru64 Get a byte or word from an input stream
getw Tru64 Get a byte or word from an input stream
getchar Tru64 Get a byte or word from an input stream
getc Tru64 Get a byte or word from an input stream
getc_unlocked Tru64 Get a byte or word from an input stream
fgetc Tru64 Get a byte or word from an input stream
getc IRIX get character or word from a stream
putc IRIX put character or word on a stream
getwc IRIX get wchar_t character or word from a stream
fputc OpenBSD output a character or word to a stream
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service