_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
| Routine | En-tête requis |
|---|---|
_getw |
<stdio.h> |
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