_putw

Écrit un entier dans un flux.

Syntaxe

int _putw(
   int binint,
   FILE *stream
);

Paramètres

binint
Entier binaire à sortir.

stream
Pointeur désignant la structure FILE.

Valeur retournée

Retourne la valeur écrite. La valeur de retour EOF peut indiquer une erreur. Sachant que EOF est aussi une valeur entière légitime, utilisez ferror pour vérifier une erreur. Si stream est un pointeur null, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction affecte la valeur errno à EINVAL et retourne EOF.

Pour plus d’informations sur ces codes d’erreur et d’autres codes d’erreur, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

La _putw fonction écrit une valeur binaire de type int à la position actuelle du flux. _putw Elle n’affecte pas l’alignement des éléments dans le flux et n’assume pas d’alignement spécial. _putw vise principalement à assurer la compatibilité avec les bibliothèques précédentes. Des problèmes de portabilité peuvent se présenter avec _putw, car la taille d’un int et l’ordre des octets au sein d’un int diffèrent d’un système à l’autre.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Exemple

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

Sortie

Wrote ten words

Voir aussi

E/S de flux
_getw