getc， getwc

项目
02/21/2013

读取流中的字符。

int getc( 
   FILE *stream 
);
wint_t getwc( 
   FILE *stream 
);

参数

stream
输入流。

返回值

返回读取的字符。若要指示读取错误或文件结尾条件， getc 返回 EOF，并且， getwc 返回 WEOF。对于 getc，请使用 ferror 或 feof 检查错误或文件结尾。如果 stream 是 NULL， getc 和 getwc 调用无效参数处理程序，如参数验证所述。如果执行允许继续，这些函数返回getwc的 EOF (或WEOF ) 并设置 errno 到 EINVAL。

请参见 _doserrno、 errno、 _sys_errlist 和 _sys_nerr 有关这些内容的更多信息以及其他情况下，错误代码。

备注

每个实例读取单个字符从文件在当前位置并将关联的文件指针 (如果定义) 指向下一个字符。文件与 stream。

因此这些功能锁定调用线程和是线程安全的。有关非固定版本，请参见 _getc_nolock， _getwc_nolock。

实例特定的备注。

实例	备注
getc	和 fgetc相同，但是，实现充当功能和作为宏。
getwc	getc的宽字符版本。读取多字节字符或宽字符，根据可能的选择 stream 在文本模式或二进制模式打开。

一般文本例程映射

TCHAR.H 实例	未定义的 _UNICODE _MBCS	定义的 _MBCS	定义的 _UNICODE
_gettc	getc	getc	getwc

要求

实例	必需的头
getc	stdio.h
getwc	stdio.h 或 wchar.h

有关其他的兼容性信息，请参见中介绍的兼容性。

示例

// crt_getc.c
// Use getc to read a line from a file.

#include <stdio.h>

int main()
{
    char buffer[81];
    int i, ch;
    FILE* fp;
    
    // Read a single line from the file "crt_getc.txt". 

    fopen_s(&fp, "crt_getc.txt", "r");
    if (!fp)
    {
       printf("Failed to open file crt_getc.txt.\n");
       exit(1);
    }

    for (i = 0; (i < 80) && ((ch = getc(fp)) != EOF)
                         && (ch != '\n'); i++)
    {
        buffer[i] = (char) ch;
    }
       
    // Terminate string with a null character 
    buffer[i] = '\0';
    printf( "Input was: %s\n", buffer);

    fclose(fp);
}