getc, getwc

Считывает символ из потока.

Синтаксис

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

Параметры

stream
Входной поток.

Возвращаемое значение

Возвращает считанный символ. Чтобы указать на ошибку чтения или конец файла, функция getc возвращает EOF, а getwc возвращает WEOF. Для функции getc следует использовать ferror или feof для проверки наличия ошибки или достижения конца файла. Если stream имеет значение NULL, getc и getwc вызов недопустимого обработчика параметров, как описано в разделе "Проверка параметров". Если выполнение разрешено продолжать, эти функции возвращаются EOF (или WEOF для getwc), а также задают значение 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.

См. также

Потоковый ввод-вывод
fgetc, fgetwc
_getch, _getwch
putc, putwc
ungetc, ungetwc