_getw

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

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

int _getw(   
   FILE *stream   
);  

Paramètres

stream
Pointeur vers le FILE structure.

_getwRetourne la valeur entière lue. Une valeur de retour de EOF indique une erreur ou la fin du fichier. Toutefois, étant donné que la EOF valeur 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 est 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 une valeur EOF.

Le _getw fonction lit la valeur binaire suivante de 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 suivant non lu. _getwn’assume pas tout alignement spécial d’éléments dans le flux. Problèmes de portage peuvent se produire avec _getw , car la taille de la int type et l’ordre des octets dans le int type diffèrent entre les systèmes.

RoutineEn-tête requis
_getw<stdio.h>

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

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

Line one.  
Line two.  

Sortie

First data word in file: 0x656e694c  

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Flux d’e/s
_putw

Afficher: