_getw

obtiene un entero de una secuencia.

int _getw( 
   FILE *stream 
);

Parámetros

• stream
  puntero a la estructura de FILE .

Valor devuelto

_getw devuelve la lectura del valor entero.Un valor devuelto de EOF indica un error o el final del archivo.Sin embargo, como el valor de EOF también es un valor entero, un uso feof o ferror legítimo para comprobar un final de archivo o una condición de error.Si stream es NULL, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, errno se establece en EINVAL y la función devuelve EOF.

Comentarios

La función de _getw lee el valor binario siguiente de int tipo de archivo asociado a stream y aumenta el puntero de archivo asociado (si hay alguno) para señalar al carácter no leídos siguiente._getw no supone ninguna alineación especial de elementos de la secuencia.Los problemas con trasladar pueden aparecer con _getw porque el tamaño de int escrito y el orden de bytes dentro del tipo de int difieren entre los sistemas.

Requisitos

rutina	Encabezado necesario
_getw	<stdio.h>

Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.

Ejemplo

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

entrada: crt_getw.txt

Line one.
Line two.

Output

First data word in file: 0x656e694c

Equivalente en .NET Framework

No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.

Vea también

Referencia

E/S de la secuencia

_putw