_putw_putw

Écrit un entier dans un flux.Writes an integer to a stream.

SyntaxeSyntax

int _putw(
   int binint,
   FILE *stream
);

ParamètresParameters

binintbinint
Entier binaire à sortir.Binary integer to be output.

streamstream
Pointeur désignant la structure FILE.Pointer to the FILE structure.

Valeur de retourReturn Value

Retourne la valeur écrite.Returns the value written. Une valeur de retour de EOF peut indiquer une erreur.A return value of EOF might indicate an error. Comme EOF est également une valeur entière légitime , utilisez l' attaquant pour vérifier une erreur.Because EOF is also a legitimate integer value, use ferror to verify an error. Si Stream est un pointeur null, le gestionnaire de paramètres non valides est appelé, comme décrit dans validation de paramètre.If stream is a null pointer, the invalid parameter handler is invoked, as described in Parameter Validation. Si l’exécution est autorisée à se poursuivre, cette fonction affecte à errno la valeur EINVAL et retourne EOF.If execution is allowed to continue, this function sets errno to EINVAL and returns EOF.

Pour obtenir des informations sur ces codes d’erreur et les autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.For information about these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

NotesRemarks

La fonction _putw écrit une valeur binaire de type int à la position actuelle du flux.The _putw function writes a binary value of type int to the current position of stream. _putw n’affecte pas l’alignement des éléments dans le flux et n’assume pas l’alignement spécial._putw does not affect the alignment of items in the stream nor does it assume any special alignment. _putw est principalement destiné à la compatibilité avec les bibliothèques précédentes._putw is primarily for compatibility with previous libraries. Des problèmes de portabilité peuvent survenir avec _putw , car la taille d’un int et l’ordre des octets dans un int diffèrent entre les systèmes.Portability problems might occur with _putw because the size of an int and the ordering of bytes within an int differ across systems.

Configuration requiseRequirements

RoutineRoutine En-tête requisRequired header
_putw_putw <stdio.h><stdio.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.For more compatibility information, see Compatibility.

BibliothèquesLibraries

Toutes les versions des bibliothèques Runtime C.All versions of the C run-time libraries.

ExempleExample

// 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 );
}

SortieOutput

Wrote ten words

Voir aussiSee also

E/S de fluxStream I/O
_getw_getw