_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.