_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 retornado de EOF pode indicar um erro. Porque EOF também é um valor inteiro legítimo, uso ferror Para verificar se um erro. If stream é um ponteiro nulo, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essa função define errno para EINVAL e retornos EOF.

Para obter informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist e _sys_nerr.

Comentários

The _putw function writes a binary value of type int to the current position of stream. _putw does not affect the alignment of items in the stream nor does it assume any special alignment._putw é principalmente para compatibilidade com bibliotecas anteriores. Podem ocorrer problemas de portabilidade com _putw porque o dimensionar de um int e a ordenação 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 do C em time de execução bibliotecas.

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

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.

Consulte também

Referência

Fluxo de E/S

_getw