_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.