Partager via


_getw

Obtient un entier à partir d'un flux de données.

int _getw( 
   FILE *stream 
);

Paramètres

  • stream
    Pointeur vers la structure FILE.

Valeur de retour

_getw retourne la valeur entière lue. La Valeur de retour deEOF indique soit une erreur soit la fin du fichier. Toutefois, la valeur EOF est également une valeur entière, utilisez feof ou ferror pour vérifier lune condition de fin de fichier ou d'erreur. Si stream est NULL, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, errno est défini comme EINVAL et la fonction retourne EOF.

Notes

La fonction _getw lit la valeur binaire suivante du type int du fichier associé à stream et incrémente le pointeur de fichier associé (s'il y en a un) pour pointer vers le caractère non lu suivant. _getw n'adopte pas d'alignement particulier d'items dans le flux. Les problèmes liés au portage peuvent avoir lieu avec _getw car la taille du type int et l'ordre des octets dans le type int diffèrent entre les systèmes.

Configuration requise

Routine

En-tête requis

_getw

<stdio.h>

Pour plus d'informations sur la 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 Exemples d'appel de plateforme.

Voir aussi

Référence

E/S de flux

_putw