_getw_getw

Obtient un entier à partir d’un flux.Gets an integer from a stream.

SyntaxeSyntax

int _getw(
   FILE *stream
);

ParamètresParameters

streamstream
Pointeur désignant la structure FILE.Pointer to the FILE structure.

Valeur de retourReturn Value

_getw retourne la valeur entière lue._getw returns the integer value read. Une valeur de retour de EOF indique une erreur ou la fin du fichier.A return value of EOF indicates either an error or end of file. Toutefois, étant donné que la valeur EOF est également une valeur entière légitime, utilisez feof ou un pour vérifier une condition d’erreur ou de fin de fichier.However, because the EOF value is also a legitimate integer value, use feof or ferror to verify an end-of-file or error condition. Si Stream a la valeur null, le gestionnaire de paramètres non valides est appelé, comme décrit dans validation de paramètre.If stream is NULL, the invalid parameter handler is invoked, as described in Parameter Validation. Si l’exécution est autorisée à se poursuivre, errno a la valeur EINVAL et la fonction retourne EOF.If execution is allowed to continue, errno is set to EINVAL and the function returns EOF.

NotesRemarks

La fonction _getw lit la valeur binaire suivante de type int à partir du fichier associé au flux et incrémente le pointeur de fichier associé (le cas échéant) pour pointer vers le caractère non lu suivant.The _getw function reads the next binary value of type int from the file associated with stream and increments the associated file pointer (if there is one) to point to the next unread character. _getw ne prend pas en considération l’alignement spécial des éléments dans le flux._getw does not assume any special alignment of items in the stream. Des problèmes de Portage peuvent survenir avec _getw , car la taille du type int et l’ordre des octets dans le type int diffèrent entre les systèmes.Problems with porting can occur with _getw because the size of the int type and the ordering of bytes within the int type differ across systems.

Configuration requiseRequirements

RoutineRoutine En-tête requisRequired header
_getw_getw <stdio.h><stdio.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.For more compatibility information, see Compatibility.

ExempleExample

// 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.txtInput: crt_getw.txt

Line one.
Line two.

SortieOutput

First data word in file: 0x656e694c

Voir aussiSee also

E/S de fluxStream I/O
_putw_putw