Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

fgetc，fgets，getc，getchar，ungetc-字符和字符串的输入

语法

#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()从流中读取下一个字符，并以无符号字符的形式将其返回给int，或者在文件或错误结束时返回EOF。

getc()等效于fgetc()，但它可以实现为对流进行多次评估的宏。

getchar()等效于getc(stdin)。

fgets()最多从流中读取小于大小的字符，并将其存储到s指向的缓冲区中。在EOF或换行符之后停止读取。如果读取换行符，则将其存储到缓冲区中。终止空字节(aq \ 0aq)存储在缓冲区中的最后一个字符之后。

ungetc()将c推回流，转换为无符号字符，可用于后续读取操作。推回的字符将以相反的顺序返回；仅保证一次推回。

此处描述的函数的调用可以相互混合，也可以与stdio库中针对相同输入流的其他输入函数的调用混合在一起。

有关非锁定对象，请参见unlocked_stdio(3)。

返回值

fgetc()，getc()和getchar()返回以无符号字符形式读取的字符，该字符在文件或错误结束时转换为int或EOF。

如果成功，则fgets()返回s，如果错误或在未读取任何字符的情况下发生文件结尾，则返回NULL。

ungetc()成功返回c，错误返回EOF。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

POSIX.1-2001，POSIX.1-2008，C89，C99。

建议不要将来自stdio库的对输入函数的调用与对与输入流相关联的文件描述符的read(2)的低级调用混合在一起。结果将是不确定的，并且很可能不是您想要的。

另外参见

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)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。