fgets, fgetws

Статья
04/10/2013

Получает строку из потока.

char *fgets( 
   char *str,
   int n,
   FILE *stream 
);
wchar_t *fgetws( 
   wchar_t *str,
   int n,
   FILE *stream 
);

Параметры

str
Место хранения для данных.
n
Максимальное число символов, которое необходимо считать.
stream
Указатель на FILE структура.

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

Каждая из этих функций возвращает str.NULL возвращает для указания ошибки или условие конца файла.Используйте feof OR ferror определить, произошла ли ошибка.If str OR stream указатель null или n меньше или равно нулю, эта функция вызывает обработчик недопустимого параметра, как описано в разделе Проверка параметров.Если выполнение может продолжить, errno равно EINVAL и функция возвращает NULL.

См. _doserrno, errno, _sys_errlist и _sys_nerr дополнительные сведения об этих и других, кодов ошибок.

Заметки

fgets функция считывает строку из ввода stream аргумент и сохраняет его в пределах str.fgets считывает символы из позиции текущего потока и включения первый символ новой строки к концу потока или до тех пор, пока число считанных символов не равно n - 1.Результат stored in str добавляет с нуль-символом.Символ новой строки, если чтение, включенный в строке.

fgetws версия расширенных символов fgets.

fgetws считывает аргумента расширенных символов str например, строка символов или если строка символов согласно stream откроется в режиме текст или binary, соответственно.Дополнительные сведения об использовании режима текста и типа binary в Юникоде и multibyte stream-I/O см. в разделе ВВОДА-ВЫВОДА текста и файла режим binary и Поток ВВОДА-ВЫВОДА в юникоде в режимах текста и binary.

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

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

Требования

Функция	Обязательный заголовок
fgets	<stdio.h>
fgetws	<stdio.h> OR <wchar.h>

Дополнительные сведения о совместимости см. Совместимость во введении.

Пример

// crt_fgets.c
// This program uses fgets to display
// a line from a file on the screen.
//

#include <stdio.h>

int main( void )
{
   FILE *stream;
   char line[100];

   if( fopen_s( &stream, "crt_fgets.txt", "r" ) == 0 )
   {
      if( fgets( line, 100, stream ) == NULL)
         printf( "fgets error\n" );
      else
         printf( "%s", line);
      fclose( stream );
   }
}