putw - Maschinenwort in Datenstrom schreiben

Definition	#include <stdio.h> int putw(int w, FILE *stream);
Beschreibung	putw() schreibt das Maschinenwort w auf den Ausgabestrom stream an die Position, auf die der Lese-/Schreibzeiger zeigt, falls er definiert ist. Die Größe eines Maschinenworts entspricht dem Datentyp int und ist von Rechner zu Rechner verschieden. Im C-Laufzeitsystem ist ein int-Datentyp 4 Byte lang. putw() setzt keine bestimmte Ausrichtung der Datei voraus und verursacht auch keine solche. Die Strukturkomponenten st_ctime und st_mtime der Datei werden zwischen der erfolgreichen Ausführung von putw() und der nächsten erfolgreichen Beendigung eines Aufrufs von fflush() oder fclose() für denselben Datenstrom oder einem Aufruf von exit() oder abort() für die Änderung markiert (siehe sys/stat.h). putw() ist nicht threadsicher.
Returnwert	0	bei Erfolg.
	!= 0	bei Fehler. Das Fehlerkennzeichen für den Datenstrom wird gesetzt. errno wird gesetzt, um den Fehler anzuzeigen.
	BS2000
	EOF	bei Fehler
Fehler	Siehe fputc().
Hinweise	Auf Grund der möglichen Unterschiede in Maschinenwortgröße und Byteanordnung sind Dateien, die mit putw() geschrieben wurden, rechnerabhängig und sollten nicht mit getw() auf einem anderen Rechner gelesen werden. Da putw() Fehler nicht explizit anzeigt (-1 ist ein gültiger Integer-Wert), sollten Sie zusätzlich ferror() verwenden, um abzuprüfen, ob vor oder nach dem Schreiben ein Fehler auftrat. Die Zeichen werden nicht sofort in die externe Datei geschrieben, sondern in einemC-internen Puffer zwischengespeichert (siehe Abschnitt "Pufferung von Datenströmen“). Bei der Ausgabe in Textdateien werden die Steuerzeichen für Zwischenraum (\n, \t, etc.) je nach Art der Textdatei in ihre entsprechende Wirkung umgesetzt (siehe Abschnitt "Zwischenraumzeichen“). Ob putw() für eine BS2000- oder eine POSIX-Datei ausgeführt wird, hängt von der Programmumgebung ab.
Siehe auch	fopen(), fputc(), fwrite(), getw(), stdio.h, sys/stat.h.