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 将调用无效参数处理程序，如参数验证中所述。 如果允许执行继续，则这些功能将 errno 设置为 EINVAL 并返回 EOF。

备注

其中每个函数均从与 stream 关联的文件的当前位置读取单个字符。 然后该函数递增关联的文件指针（如果已定义）以指向下一个字符。 如果流位于文件结尾，则设置流的文件结尾指示器。

fgetc 等效于 getc，但仅作为函数实现，而不是同时作为函数和宏实现。

fgetwc 是 fgetc 的宽字符版本；它根据 stream 是在文本模式还是二进制模式中打开，来将 c 读取为多字节字符或宽字符。

带 _nolock 后缀的版本相同，但可能受到其他线程的干扰。

有关在文本模式和二进制模式下处理宽字符和多字节字符的详细信息，请参阅文本模式和二进制模式下的 Unicode 流 I/O。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

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.

输出

Line one.
Line two.

另请参阅

流 I/O
fputc、fputwc
getc、getwc