Partilhar via


_putw

Grava um valor inteiro em um fluxo.

Sintaxe

int _putw(
   int binint,
   FILE *stream
);

Parâmetros

binint
Inteiro binário de saída.

stream
Ponteiro para a estrutura FILE.

Valor retornado

Retorna o valor gravado. Um valor retornado de EOF pode indicar um erro. Como EOF também é um valor inteiro legítimo, use ferror para verificar se há um erro. Se stream for um ponteiro nulo, o manipulador de parâmetro inválido será chamado, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essa função definirá errno para EINVAL e retornará EOF.

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

Comentários

A _putw função grava um valor binário do tipo int na posição atual do fluxo. _putw não afeta o alinhamento de itens no fluxo nem assume nenhum alinhamento especial. _putw destina-se principalmente à compatibilidade com bibliotecas anteriores. Problemas de portabilidade podem ocorrer com _putw, pois o tamanho de um int e a ordenação de bytes dentro de um int diferem entre sistemas.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

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

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Bibliotecas

Todas as versões das bibliotecas em 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

Confira também

E/S de fluxo
_getw