_putw
Grava um número inteiro em um fluxo.
int _putw(
int binint,
FILE *stream
);
Parâmetros
binint
Binário inteiro para ser impressos.stream
Ponteiro para o arquivo estrutura.
Valor de retorno
Retorna o valor escrito.Um valor de retorno de EOF pode indicar um erro.Porque EOF também é um valor inteiro legítimo, uso ferror para verificar se um erro.Se stream é um ponteiro nulo, 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, essa função define errno para EINVAL e retorna EOF.
Para obter informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist e _sys_nerr.
Comentários
O _putw função grava um valor binário do tipo int para a posição atual do fluxo._putw não afeta o alinhamento dos itens no fluxo nem oferece assumir qualquer alinhamento especial. _putwé principalmente para compatibilidade com bibliotecas anteriores.Problemas de portabilidade poderão ocorrer com _putw porque o tamanho de um int e a ordem dos bytes dentro de um int diferem entre sistemas.
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_putw |
<stdio.h> |
Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.
Bibliotecas
Todas as versões da bibliotecas de tempo de execução c.
Exemplo
// crt_putw.c
/* This program uses _putw to write a
* word to a stream, then performs an error check.
*/
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
FILE *stream;
unsigned u;
if( fopen_s( &stream, "data.out", "wb" ) )
exit( 1 );
for( u = 0; u < 10; u++ )
{
_putw( u + 0x2132, stream ); /* Write word to stream. */
if( ferror( stream ) ) /* Make error check. */
{
printf( "_putw failed" );
clearerr_s( stream );
exit( 1 );
}
}
printf( "Wrote ten words\n" );
fclose( stream );
}
Saída
Wrote ten words
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.