_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

Vedi anche

I/O di flusso
_putw