Movatterモバイル変換

fgetc(3) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ATTRIBUTES \|STANDARDS \|HISTORY \|NOTES \|SEE ALSO \|COLOPHON

fgetc(3)                 Library Functions Manualfgetc(3)

NAME top

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

LIBRARY top

       Standard C library (libc,-lc)

SYNOPSIS top

#include <stdio.h>int fgetc(FILE *stream);int getc(FILE *stream);int getchar(void);char *fgets(int size;chars[restrictsize], intsize, FILE *restrictstream);int ungetc(intc, FILE *stream);

DESCRIPTION top

fgetc() reads the next character fromstream and returns it as anunsigned char cast to anint, orEOFon end of file or error.getc() is equivalent tofgetc() except that it may be implemented       as a macro which evaluatesstream more than once.getchar() is equivalent togetc(stdin).fgets() reads in at most one less thansize characters fromstream       and stores them into the buffer pointed to bys.  Reading stops       after anEOFor 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() pushesc back tostream, cast tounsigned 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 thestdio library for       the same input stream.       For nonlocking counterparts, seeunlocked_stdio(3).

RETURN VALUE top

fgetc(),getc(), andgetchar() return the character read as anunsigned char cast to anint orEOFon end of file or error.fgets() returnss on success, and NULL on error or when end of       file occurs while no characters have been read.ungetc() returnsc on success, orEOFon error.

ATTRIBUTES top

       For an explanation of the terms used in this section, seeattributes(7).       ┌──────────────────────────────────────┬───────────────┬─────────┐       │Interface│Attribute│Value│       ├──────────────────────────────────────┼───────────────┼─────────┤       │fgetc(),fgets(),getc(),getchar(), │ Thread safety │ MT-Safe │       │ungetc()                             │               │         │       └──────────────────────────────────────┴───────────────┴─────────┘

STANDARDS top

       C11, POSIX.1-2008.

HISTORY top

       POSIX.1-2001, C89.

NOTES top

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

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-06-28fgetc(3)

Pages that refer to this page:auplugin_fgets(3), EOF(3const), ferror(3), fgetwc(3), fgetws(3), flockfile(3), fpurge(3), fseek(3), getline(3), gets(3), getw(3), getwchar(3), puts(3), rpmatch(3), scanf(3), sscanf(3), stdio(3), ungetwc(3)