fgetc, fgets, getc, getchar, ungetc - input of characters and strings


   #include <stdio.h>

   int fgetc(FILE *stream);

   char *fgets(char *s, int size, FILE *stream);

   int getc(FILE *stream);

   int getchar(void);

   int ungetc(int c, FILE *stream);


   fgetc()  reads  the  next  character  from  stream and returns it as an
   unsigned char cast to an int, or EOF on end of file or error.

   getc() is equivalent to fgetc() except that it may be implemented as  a
   macro which evaluates stream more than once.

   getchar() is equivalent to getc(stdin).

   fgets()  reads in at most one less than size characters from stream and
   stores them into the buffer pointed to by s.  Reading  stops  after  an
   EOF  or a newline.  If a newline is read, it is stored into the buffer.
   A terminating null byte ('\0') is stored after the  last  character  in
   the buffer.

   ungetc()  pushes  c  back to stream, cast to unsigned char, where it is
   available for subsequent read operations.  Pushed-back characters  will
   be returned in reverse order; only one pushback is guaranteed.

   Calls  to the functions described here can be mixed with each other and
   with calls to other input functions from the stdio library for the same
   input stream.

   For nonlocking counterparts, see unlocked_stdio(3).


   fgetc(),  getc() and getchar() return the character read as an unsigned
   char cast to an int or EOF on end of file or error.

   fgets() returns s on success, and NULL on error or  when  end  of  file
   occurs while no characters have been read.

   ungetc() returns c on success, or EOF on error.


   For   an   explanation   of   the  terms  used  in  this  section,  see

   │InterfaceAttributeValue   │
   │fgetc(), fgets(), getc(), │ Thread safety │ MT-Safe │
   │getchar(), ungetc()       │               │         │


   POSIX.1-2001, POSIX.1-2008, C89, C99.

   It is not advisable to mix calls to  input  functions  from  the  stdio
   library  with  low-level  calls  to  read(2)  for  the  file descriptor
   associated with the input stream; the results  will  be  undefined  and
   very probably not what you want.


   read(2), write(2), ferror(3), fgetwc(3), fgetws(3), fopen(3), fread(3),
   fseek(3),  getline(3),   gets(3),   getwchar(3),   puts(3),   scanf(3),
   ungetwc(3), unlocked_stdio(3), feature_test_macros(7)


   This  page  is  part of release 4.09 of the Linux man-pages project.  A
   description of the project, information about reporting bugs,  and  the
   latest     version     of     this    page,    can    be    found    at

More Linux Commands

getmntent_r(3) - get file system descriptor file entry......
These routines are used to access the filesystem description file /etc/fstab and the mounted filesystem description file /etc/mtab. The setmntent() function ope

gnutls_certificate_activation_time_peers(3) - API function
This function will return the peers certificate activation time. This is the creation time for openpgp keys. RETURNS (time_t)-1 on error. DEPRECATED gnutls_cert

PerlIO::encoding(3pm) - encoding layer - Linux manual page
This PerlIO layer opens a filehandle with a transparent encoding filter. On input, it converts the bytes expected to be in the specified character set and encod

XtCreatePopupShell(3) - create a popup shell (Man Page).....
The XtCreatePopupShell function ensures that the specified class is a subclass of Shell and, rather than using insert_child to attach the widget to the parents

lastb(1) - show listing of last logged in users (Man Page)
Last searches back through the file /var/log/wtmp (or the file designated by the -f flag) and displays a list of all users logged in (and out) since that file w

XFindContext(3) - associative look-up routines (Man Page)...
If an entry with the specified resource ID and type already exists, XSaveContext overrides it with the specified context. The XSaveContext function returns a no

set_form_win(3form) - make and break form window and subwind
Every form has an associated pair of curses windows. The form window displays any title and border associated with the window; the form subwindow displays the i

CPAN::Nox(3pm) - Wrapper around CPAN.pm without using any XS
This package has the same functionality as CPAN .pm, but tries to prevent the usage of compiled extensions during its own execution. Its primary purpose is a re

enforce(8) set an AppArmor security profile to enforce mode
aa-enforce is used to set one or more profiles to enforce mode. This command is only relevant in conjunction with the aa-complain utility which sets a profile t

DBI::Profile(3pm) - Performance profiling and benchmarking f
The DBI::Profile module provides a simple interface to collect and report performance and benchmarking data from the DBI . For a more elaborate interface, suita

ec(1ssl) EC key processing (Commands - Linux manual page)...
The ec command processes EC keys. They can be converted between various forms and their components printed out. Note OpenSSL uses the private key format specifi

prefresh(3ncurses) - create and display curses pads.........
The newpad routine creates and returns a pointer to a new pad data structure with the given number of lines, nlines, and columns, ncols. A pad is like a window,

We can't live, work or learn in freedom unless the software we use is free.