fgets, fgetws

Articolo
03/26/2013

ottenere una stringa da un flusso.

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

Parametri

str
percorso di archiviazione per i dati.
n
Numero massimo di caratteri da leggere.
stream
puntatore a FILE struttura.

Valore restituito

Ognuno di questi valori restituiti da funzioni str.NULL viene restituito per indicare un errore o una condizione di fine file.utilizzo feof o ferror per determinare se si è verificato un errore.se str o stream è un puntatore null, o n è minore o uguale a zero, richiama di questa funzione il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, errno è impostato su EINVAL e restituisce un valore di funzione NULL.

vedere _doserrno, errno, _sys_errlist e _sys_nerr per ulteriori informazioni su questi e su altri, codici di errore.

Note

fgets la funzione legge una stringa da l stream argomento e archiviati in str.fgets legge caratteri dalla posizione corrente del flusso a e includere il primo carattere di nuova riga, alla fine del flusso, o fino al numero di caratteri lettura è uguale a n - 1, qualsiasi versione viene prima nell'.Il risultato memorizzato in str viene accodato un carattere null.Il carattere di nuova riga, se lettura, viene incluso nella stringa.

fgetws è una versione a caratteri estesi di fgets.

fgetws legge l'argomento a caratteri estesi str come una stringa di caratteri multibyte o stringa di caratteri estesi a seconda di come stream viene aperto in modalità testo o in modalità binario, rispettivamente.Per ulteriori informazioni sull'utilizzo delle modalità del binario e del testo in formato Unicode e in multibyte stream-I/O, vedere La modalità del binario di testo e archivia I/O e Flusso I/O Unicode in modalità binario e del testo.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_fgetts	fgets	fgets	fgetws

Requisiti

Funzione	Intestazione di associazione
fgets	<stdio.h>
fgetws	<stdio.h> o <wchar.h>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Esempio

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