_putw
Schreibt eine ganze Zahl einem Stream.
int _putw(
int binint,
FILE *stream
);
Parameter
binint
Ausgegeben werden ganze binären Ganzzahlwert.stream
Zeiger zu der FILE-Struktur.
Rückgabewert
Gibt dem geschriebenen Wert zurück. Bei dem Rückgabewert EOF könnte einen Fehler an. Da EOF auch ein legitimer ganzzahliger Wert, mit ferror, einen Fehler zu überprüfen. Wenn stream ein NULL-Zeiger ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, legt diese Funktion errno auf EINVAL fest und gibt EOF zurück.
Weitere Informationen über diese und andere Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Die _putw-Funktion wird ein Binärwert des Typs int zur aktuellen Position des Streams. _putw beeinflusst die Ausrichtung von Elementen im Stream noch davon ausgegangen wird keine besondere Ausrichtung. _putw ist hauptsächlich für die Kompatibilität mit früheren Bibliotheken. Portabilitätsprobleme können sich mit _putw auf, weil die Größe von int und die Reihenfolge von Bytes innerhalb int Systemen zu unterscheiden.
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_putw |
<stdio.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Bibliotheken
Alle Versionen C-Laufzeitbibliotheken.
Beispiel
// 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 );
}
Ausgabe
Wrote ten words
.NET Framework-Entsprechung
Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.