Compartir a través de


_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 de parámetros no válidos, 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.

Resultados

First data word in file: 0x656e694c

Equivalente en .NET Framework

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

Vea también

Referencia

E/S de secuencia

_putw