getc, getwc

Статья
06/09/2015

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

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.

См. раздел _doserrno, errno, _sys_errlist, and _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);
}