fgetc, fgetwc

Статья
02/20/2013

Чтение знаков из потока.

int fgetc( 
   FILE *stream 
);
wint_t fgetwc( 
   FILE *stream 
);

Параметры

stream
Указатель на FILE структура.

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

fgetc возвращает символ как чтение int или EOF чтобы отобразить ошибку или конец файла.fgetwc возвращает, например, a wint_t, расширенный символ, который соответствует знаку чтения или возвращает WEOF чтобы отобразить ошибку или конец файла.Для обеих функций, используйте feof OR ferror различать ошибку и условием конца файла.Если чтения возникает ошибка, то индикатор ошибки для потока.If stream существует NULL" fgetc и fgetwc вызовите недопустимый обработчик параметра, как описано в разделе Проверка параметров.Если выполнение может быть продолжено, то эти функции установки errno В EINVAL и извлечение EOF.

Заметки

Каждая из этих функций считывает один знак, начиная с текущей позиции файла, связанного с stream.Функция затем увеличивает связанный указатель файла (если указано), то для указания к следующему знаку.Если поток, в конце файла признак конца файла для потока.

fgetc равно getcреализует, но только в качестве функции, а не функции и макроса.

fgetwc версия расширенных символов fgetc; он считывает c многобайтовый как символ или расширенный в соответствии с если символ stream откроется в режиме текст или binary.

Версии с _nolock суффикс идентичны за исключением того, что они не защищены от взаимодействия с другими потоками.

Дополнительные сведения об обработке расширенных символов и многобайтовая кодировка текста и в режимах см. в разделе binary Поток ВВОДА-ВЫВОДА в юникоде в режимах текста и binary.

Сопоставления подпрограммы Родов-Текста

Подпрограмма TCHAR.H	_MBCS не заданные _UNICODE &	Указанный символ _MBCS	Указанный _UNICODE
_fgettc	fgetc	fgetc	fgetwc

Требования

Функция	Обязательный заголовок
fgetc	<stdio.h>
fgetwc	<stdio.h> OR <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 );
}