getc，getwc

  • 项目

从流中读取字符。

语法

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

参数

stream
输入流。

返回值

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

有关返回代码的详细信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

注解

每个例程从文件的当前位置读取单个字符，并增量关联的文件指针（如果已定义）以指向下一个字符。 与 stream 关联的文件。

这些函数会锁定调用线程，因此是线程安全的。 有关非锁定版本，请参阅 _getc_nolock、_getwc_nolock。

下面是例程特定的备注。

例程 备注
getc 与 fgetc 一样，但实现为函数和宏。
getwc getc 的宽字符版本。 根据 stream 是在文本模式还是二进制模式中打开，读取多字节字符或宽字符。

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

一般文本例程映射

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);
}

输入：crt_getc.txt

Line one.
Line two.

输出

Input was: Line one.

另请参阅

流 I/O
fgetc、fgetwc
_getch、_getwch
putc、putwc
ungetc、ungetwc