_getw

Obtient un entier à partir d’un flux.

Syntaxe

int _getw(
   FILE *stream
);

Paramètres

stream
Pointeur désignant la structure FILE.

Valeur retournée

_getw retourne la valeur entière lue. Une valeur de retour égale à EOF indique une erreur ou la fin du fichier. Toutefois, étant donné que la valeur EOF est également une valeur d’entier légitime, utilisez feof ou ferror pour vérifier une condition d’erreur ou de fin de fichier. Si stream a la valeur NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l’exécution est autorisée à se poursuivre, errno a la valeur EINVAL et la fonction retourne EOF.

Notes

La _getw fonction lit la valeur binaire suivante du type int à partir du fichier associé stream et incrémente le pointeur de fichier associé (le cas échéant) pour pointer vers le caractère non lu suivant. _getw ne suppose aucun alignement spécial des éléments dans le flux. Des problèmes de portage peuvent se produire avec _getw, car la taille du type int et l’ordre des octets dans le type int diffèrent d’un système à l’autre.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

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

Entrée : crt_getw.txt

Line one.
Line two.

Sortie

First data word in file: 0x656e694c

Voir aussi

E/S de flux
_putw