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