_getw
Obtém um número inteiro de um fluxo.
int _getw(
FILE *stream
);
Parâmetros
- stream
Ponteiro para o FILE estrutura.
Valor de retorno
_getw Retorna o valor inteiro de leitura. Um valor retornado de EOF indica um erro ou o participante do arquivo. No entanto, porque o EOF também é um valor inteiro legítimo, uso feof ou ferror Para verificar uma condição de erro ou de participante de arquivo. If stream é NULL, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. If execution is allowed to continue, errno is set to EINVAL and the function returns EOF.
Comentários
The _getw função lê o valor binário próximo do tipo int do arquivo associado stream e incrementa o ponteiro de arquivo associado (se houver) para apontar para o próximo caractere não lido. _getw não assume qualquer especial alinhamento dos itens no fluxo. Podem ocorrer problemas com portagem com _getw porque o dimensionar das int tipo e a ordem dos bytes dentro de 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
Equivalente do NET Framework
Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.