fgets, fgetws
Ottiene 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 alla struttura FILE.
Valore restituito
Ognuna di queste funzioni restituisce str. NULL viene restituito per indicare un errore o una condizione di fine file. Usa feof o ferror per determinare se si è verificato un errore. Se str o stream è un puntatore null, o n è minore o uguale a zero, questa funzione invoca il gestore del parametro non valido. come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno viene impostato su EINVAL e la funzione restituisce NULL.
Vedere _doserrno, errno, _sys_errlist, e _sys_nerr per ulteriori informazioni su questi, e altri, codici di errore.
Note
La funzione fgets legge una stringa dall'argomento di input di stream e la memorizza in str. fgets legge caratteri dalla posizione corrente del flusso e include il primo carattere di una nuova riga, alla fine del flusso, o fino a che il numero di caratteri letti è uguale a n - 1, che si verifica per primo. Il risultato memorizzato in str viene accodato con un carattere null. Il carattere di nuova riga, se letto, è incluso nella stringa.
fgetws è una versione a caratteri di tipo "wide" di fgets.
fgetws legge rispettivamente l'argomento a caratteri wide str in stream come una stringa di caratteri multibyte o una stringa di caratteri estesi a seconda di come lo venga aperto rispettivamente, in modalità di testo oppure in modalità binaria. Per ulteriori informazioni sull'utilizzo delle modalità binaria e testo in formato Unicode e in stream-I/O multibyte, vedere Text and Binary Mode File I/O e Unicode Stream I/O in Text and Binary Modes.
Mapping di routine di testo generico
Routine TCHAR.H |
_UNICODE & _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
|---|---|---|---|
_fgetts |
fgets |
fgets |
fgetws |
Requisiti
Funzione |
Intestazione obbligatoria |
|---|---|
fgets |
<stdio.h> |
fgetws |
<stdio.h> o <wchar.h> |
Per ulteriori informazioni sulla compatibilità, 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 );
}
}
Input: crt_fgets.txt
Line one.
Line two.
Output
Line one.