Partager via


_putw

Écrit un entier sur un flux de données.

int _putw( 
   int binint, 
   FILE *stream  
);

Paramètres

  • binint
    Entier binaire à sortir.

  • stream
    [in] Pointeur vers la structure FILE.

Valeur de retour

Retourne la valeur écrite. Une valeur de retour de EOF peut indiquer une erreur. Comme EOF est également 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 paramètre errno à EINVAL et renvoie EOF.

Pour plus d'informations sur ces éléments et autres codes d'erreur, consultez _doserrno, errno, _sys_errlist et _sys_nerr.

Notes

La fonction _putw écrit une valeur binaire de type int à l'emplacement actuel du flux de données. _putw n'affecte pas l'alignement des éléments du flux de données ni ne suppose un alignement particulier. _putw est principalement à des fins de compatibilité avec les bibliothèques précédentes. Les problèmes de portabilité peuvent se poser avec _putw car la taille d'un int et l'ordre des octets dans un int diffèrent entre les systèmes.

Configuration requise

Routine

En-tête requis

_putw

<stdio.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

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

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Voir aussi

Référence

E/S de flux

_getw