_putw
Schreibt eine ganze Zahl in einen Stream.
Syntax
int _putw(
int binint,
FILE *stream
);
Parameter
binint
Binäre Ganzzahl wird ausgegeben.
stream
Zeiger auf die FILE-Struktur.
Rückgabewert
Gibt den geschriebenen Wert zurück. Ein Rückgabewert von EOF könnte einen Fehler anzeigen. Da EOF auch ein legitimer Ganzzahlwert ist, sollten Sie ferror verwenden, um Fehler zu überprüfen. Wenn stream ein NULL-Zeiger ist, wird der Handler für ungültige Parameter aufgerufen, wie in Parameter Validation (Parameterüberprüfung) beschrieben. Wenn die weitere Ausführung zugelassen wird, legt diese Funktion errno auf EINVAL fest und gibt EOF zurück.
Informationen zu diesen und anderen Fehlercodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno
Hinweise
Die _putw Funktion schreibt einen binären Wert vom Typ int in die aktuelle Position des Datenstroms. _putw Wirkt sich nicht auf die Ausrichtung von Elementen im Datenstrom aus, und es wird keine spezielle Ausrichtung vorausgesetzt. _putw ist in erster Linie für die Kompatibilität mit früheren Bibliotheken verantwortlich. Portabilitätsprobleme können mit _putw auftreten, da die Größe von int und die Anordnung der Bytes in int über Systeme hinweg unterschiedlich sind.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Anforderungen
| Routine | Erforderlicher Header |
|---|---|
_putw |
<stdio.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Libraries
Alle Versionen der 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 );
}
Output
Wrote ten words