_getw
Ottiene un integer da un flusso.
int _getw(
FILE *stream
);
Parametri
- stream
Puntatore alla struttura FILE.
Valore restituito
_getw restituisce il valore intero letto. Un valore restituito di EOF indica un errore o fine del file. Tuttavia, poiché il valore di EOF è un valore intero legittimo, usare feof o ferror per verificare la condizione di fine del file o di errore. Se stream è NULL, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno viene impostato su EINVAL e la funzione restituisce EOF.
Note
La funzione _getw legge il valore binario seguente di tipo int dal file associato con stream e incrementa il puntatore del file collegato (se presente) per puntare al carattere non letto seguente. _getw non assume alcun allineamento speciale degli elementi nel flusso. I problemi con il porting possono verificarsi con _getw perché la dimensione del tipo int e l'ordine dei byte all'interno del tipo int differiscono fra i sistemi.
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
_getw |
<stdio.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
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
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione standard C, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di Invocazione della Piattaforma.