_getw

obtient un entier d'un flux de données.

int _getw( 
   FILE *stream 
);

Paramètres

• stream
  Pointeur vers la structure d' FILE .

Valeur de retour

_getw retourne la lecture de valeur entière.une valeur de retour d' EOF indique une erreur ou un de fin de fichier.Toutefois, comme la valeur d' EOF est également une valeur entière, utilisez feof ou un ferror légitime pour vérifier une fin de fichier ou une condition d'erreur.si stream est NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, errno est défini à EINVAL et la fonction retourne EOF.

Notes

La fonction d' _getw lit la valeur binaire suivante du type int du fichier associé à stream et incrémente le pointeur de fichier associé (le cas échéant) pour indiquer le caractère non lu suivant._getw n'a aucun enregistrement spécial des éléments dans le flux de données.Les problèmes avec le portage peuvent se produire avec _getw car la taille du type d' int et classer des octets dans le type d' int diffèrent entre les systèmes.

Configuration requise

Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.

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

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez l' exemples d'appel de code non managé.

Voir aussi

Référence

E/S de flux

_putw