fgetc, fgetwc
Считывает символ из потока.
int fgetc(
FILE *stream
);
wint_t fgetwc(
FILE *stream
);
Параметры
- stream
Указатель на структуру FILE.
Возвращаемое значение
fgetc возвращает символ, прочтенный как int, или возвращает EOF для отображения ошибки или конца файла. fgetwc возвращает, как и wint_t, расширенный символ, который соответствует прочитанному символу, или возвращает WEOF для отображения ошибки или конца файла. Для обеих функций следует использовать feof или ferror для различения условий ошибки и конца файла. Если возникает ошибка чтения, то для потока устанавливается индикатор ошибки. Если stream равен NULL, то fgetc и fgetwc вызывают обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, эти функции устанавливают для errno значение EINVAL и возвращают EOF.
Заметки
Каждая из этих функций считывает один символ с текущей позиции файла, связанного с stream. Функция затем увеличивает указатель связанного файла (если он указан) для указания на следующий символ. Если поток находится в конце файла, для потока устанавливается индикатор конца файла.
fgetc эквивалентна getc, но реализуется только как функция, а не как функция и макрос.
fgetwc версия fgetc для расширенных символов; она считывает c как многобайтовый или расширенный символ согласно тому, открыт ли stream в текстовом или бинарном режиме.
Версии с суффиксом _nolock идентичны за исключением того, что они не защищены от взаимодействия с другими потоками.
Дополнительные сведения об обработке расширенных и многобайтовых символов в текстовом и бинарном режимах см. в разделе Unicode Stream I/O in Text and Binary Modes.
Универсальное текстовое сопоставление функций
Подпрограмма TCHAR.H |
_UNICODE & _MBCS не определены |
_MBCS определено |
_UNICODE определено |
---|---|---|---|
_fgettc |
fgetc |
fgetc |
fgetwc |
Требования
Функция |
Обязательный заголовок |
---|---|
fgetc |
<stdio.h> |
fgetwc |
<stdio.h> или <wchar.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость во введении.
Пример
// crt_fgetc.c
// This program uses getc to read the first
// 80 input characters (or until the end of input)
// and place them into a string named buffer.
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
FILE *stream;
char buffer[81];
int i, ch;
// Open file to read line from:
fopen_s( &stream, "crt_fgetc.txt", "r" );
if( stream == NULL )
exit( 0 );
// Read in first 80 characters and place them in "buffer":
ch = fgetc( stream );
for( i=0; (i < 80 ) && ( feof( stream ) == 0 ); i++ )
{
buffer[i] = (char)ch;
ch = fgetc( stream );
}
// Add null to end string
buffer[i] = '\0';
printf( "%s\n", buffer );
fclose( stream );
}
Input: crt_fgetc.txt
Line one.
Line two.
Output
Line one.
Line two.