fgets fgetws

Článek
03/26/2013

Získáte řetězec z datového proudu.

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

Parametry

str
Umístění úložiště pro data.
n
Maximální počet znaků pro čtení.
stream
Ukazatel na FILE struktury.

Vrácená hodnota

Tyto funkce vrací str.NULLje vrácena chyba nebo podmínku konce souboru.Použití feof nebo ferror určit, zda došlo k chybě.Pokud str nebo stream je nulový ukazatel nebo n je menší nebo rovna nule, tato funkce vyvolá obsluhu neplatný parametr popsaným v Ověření parametrů.Pokud je povoleno spuštění pokračovat, errno je nastavena na EINVAL a vrátí funkce NULL.

Viz _doserrno, kód chyby, _sys_errlist a _sys_nerr Další informace o těchto a jiných kódů chyb.

Poznámky

fgets Funkce načte ze vstupní řetězec stream argument a uloží jej v str.fgetsčte znaky od aktuální pozice proudu do a včetně prvního znaku nového řádku na konec proudu nebo dokud číst počet znaků je rovno n – 1, proběhne.Výsledek je uložen v str je přidán znak null.Znak nový řádek, pokud čtení, je součástí řetězce.

fgetwsje verze celého znaku fgets.

fgetwspřečte argument znak wide str jako řetězec vícebajtových znaků nebo řetězec znaků wide podle zda stream je otevřen v režimu text nebo binární, resp..Další informace o použití textu a binárních režimy v Unicode a vícebajtové proud I/O textu a binární režim souboru v/V a V/V proudu Unicode v textu a binárních režimy.

Obecný Text rutinní mapování

TCHAR.Rutina H	_UNICODE & _MBCS není definován	_MBCS, definice	_UNICODE, definice
_fgetts	fgets	fgets	fgetws

Požadavky

Function	Požadované záhlaví
fgets	<stdio.h>
fgetws	<stdio.h> nebo <wchar.h>

Další informace o kompatibilitě, viz Compatibility v úvodu.

Příklad

// 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 );
   }
}