fgetc， fgetwc
读取流中的字符。
int fgetc(
FILE *stream
);
wint_t fgetwc(
FILE *stream
);
参数
- stream
为 FILE 结构的指针。
返回值
fgetc 返回作为 int 读取的字符或返回 EOF 指示错误或文件结尾。 fgetwc 返回，作为 wint_t，对应于读取的字符的宽字符或返回 WEOF 指示错误或文件结尾。 对于两个函数，请使用 feof 或 ferror 区分错误和一个文件关闭条件之间。 如果读取错误，流的错误指示器设置。 如果 stream 是 NULL， fgetc 和 fgetwc 调用无效参数处理程序，如 参数验证所述。 如果执行允许继续，对 EINVAL 的这些功能集 errno 和返回 EOF。
备注
这些功能中的每个读取文件的当前位置的单个字符与 stream。 函数来增加关联的文件指针 (如果定义) 指向下一个字符。 如果流是在文件末尾，流的文件结尾指示符设置。
fgetc 与 getc等效，但是，仅实现为函数，而不是函数和宏。
fgetwc 是 fgetc的宽字符版本;它读取 c 作为多字节字符或宽字符，根据可能的选择 stream 在文本模式或二进制模式打开。
与 _nolock 后缀的版本与相同，但它们不从由其他线程的干扰保护。
有关处理宽字符和多字节字符的更多信息在文本和二进制模式，请参见 中的 Unicode 文本和二进制模式的流 I/O。
一般文本例程映射
TCHAR.H 实例 |
未定义的 _UNICODE _MBCS |
定义的 _MBCS |
定义的 _UNICODE |
|---|---|---|---|
_fgettc |
fgetc |
fgetc |
fgetwc |
要求
功能 |
必需的头 |
|---|---|
fgetc |
stdio.h |
fgetwc |
stdio.h 或 wchar.h |
有关其他的兼容性信息，请参见中介绍的 兼容性 。
示例
// crt_fgetc.c
// This program uses getc to read the first
// 80 input characters (or until the end of input)
// and place them into a string named buffer.
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
FILE *stream;
char buffer[81];
int i, ch;
// Open file to read line from:
fopen_s( &stream, "crt_fgetc.txt", "r" );
if( stream == NULL )
exit( 0 );
// Read in first 80 characters and place them in "buffer":
ch = fgetc( stream );
for( i=0; (i < 80 ) && ( feof( stream ) == 0 ); i++ )
{
buffer[i] = (char)ch;
ch = fgetc( stream );
}
// Add null to end string
buffer[i] = '\0';
printf( "%s\n", buffer );
fclose( stream );
}
输入:crt_fgetc.txt
Line one.
Line two.
.gif "c7sskzc1.collapse_all(zh-cn,VS.110).gif")
Output
Line one.
Line two.