_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 es sich um einen Nullzeiger handelt, wird der ungültige Parameterhandler aufgerufen, wie in der 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. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Anforderungen

Routine	Erforderlicher Header
_putw	<stdio.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Bibliotheken

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 );
}

Ausgabe

Wrote ten words

Siehe auch

Stream-E/A
_getw