Freigeben über


_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

Weitere Informationen

Stream-E/A
_getw