_getw
Ottiene un Integer da un flusso.
Sintassi
int _getw(
FILE *stream
);
Parametri
stream
Puntatore alla struttura FILE.
Valore restituito
_getw restituisce l'Integer letto. Un valore restituito di EOF indica un errore o la fine del file. Tuttavia, poiché il valore EOF è un Integer legittimo, utilizzare feof o ferror per verificare una condizione di fine del file o di errore. Se stream è NULL, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno viene impostato su EINVAL e la funzione restituisce EOF.
Osservazioni:
La _getw funzione legge il valore binario successivo di tipo int dal file associato a e incrementa il puntatore al file associato stream (se presente) in modo che punti al carattere successivo non letto. _getw non presuppone alcun allineamento speciale degli elementi nel flusso. I problemi con la portabilità possono verificarsi con _getw perché la dimensione del tipo int e l'ordine dei byte all'interno del tipo int differiscono fra i sistemi.
Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.
Requisiti
| Ciclo | Intestazione obbligatoria |
|---|---|
_getw |
<stdio.h> |
Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).
Esempio
// crt_getw.c
// This program uses _getw to read a word
// from a stream, then performs an error check.
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
FILE *stream;
int i;
if( fopen_s( &stream, "crt_getw.txt", "rb" ) )
printf( "Couldn't open file\n" );
else
{
// Read a word from the stream:
i = _getw( stream );
// If there is an error...
if( ferror( stream ) )
{
printf( "_getw failed\n" );
clearerr_s( stream );
}
else
printf( "First data word in file: 0x%.4x\n", i );
fclose( stream );
}
}
Input: crt_getw.txt
Line one.
Line two.
Output
First data word in file: 0x656e694c