_getw

Obtém um número inteiro a partir de um fluxo.

int _getw( 
   FILE *stream 
);

Parâmetros

• stream
  Ponteiro para o FILE estrutura.

Valor de retorno

_getwRetorna o valor inteiro de leitura.Um valor de retorno de EOF indica um erro ou o fim do arquivo.No entanto, porque o EOF também é um valor inteiro legítimo, use feof ou ferror para verificar se uma condição de erro ou de fim-de-arquivo.Se stream é NULL, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, errno for definido como EINVAL e a função retornará EOF.

Comentários

O _getw função lê o próximo valor binário do tipo int de arquivo associado a stream e incrementa o ponteiro de arquivo associado (se houver) para apontar para o próximo caractere não lido._getwnão assume qualquer alinhamento especial dos itens no fluxo.Problemas com portagem podem ocorrer com _getw porque o tamanho do int tipo e a ordem dos bytes dentro do int tipo diferem entre sistemas.

Requisitos

Rotina	Cabeçalho necessário
_getw	<stdio.h>

Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.

Exemplo

// 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.

Saída

First data word in file: 0x656e694c

Equivalência do .NET Framework

Não aplicável. Para chamar a função c padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Fluxo de i/O

_putw