_getw

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Obtiene un entero de una secuencia.

int _getw(   
   FILE *stream   
);  

Parámetros

stream
Puntero a la estructura de FILE.

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

El _getw función lee el siguiente valor binario de tipo int desde el archivo asociado a stream y aumenta el puntero de archivo asociado (si hay alguno) para señalar al carácter siguiente no leído. _getwno supone ninguna alineación especial de elementos de la secuencia. Pueden producirse problemas de portabilidad con _getw porque el tamaño de la int tipo y el orden de bytes de la int tipo difieren entre sistemas.

RutinaEncabezado necesario
_getw<stdio.h>

Para obtener más información sobre compatibilidad, vea Compatibility en la introducción.

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

Line one.  
Line two.  

Salida

First data word in file: 0x656e694c  

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.

E/S de secuencia
_putw

Mostrar: