fputws - Langzeichenkette in Datenstrom schreiben,

Definition	#include <wchar.h> Optional #include <stdio.h> (Ende) int fputws(const wchar_t *ws, FILE *stream);
Beschreibung	fputws() schreibt eine Zeichenkette mit einem Nullbyte entsprechend der Zeichenkette aus Langzeichenwerten, auf die ws zeigt, auf den Datenstrom, auf den stream zeigt. Es wird kein Zeichen geschrieben, das dem abschließenden Nullbyte entspricht. Die Strukturkomponenten st_ctime und st_mtime der Datei werden zwischen der erfolgreichen Ausführung von fputws() 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). Einschränkung In dieser Version des C-Laufzeitsystems werden nur 1-Byte-Zeichen als Langzeichen unterstützt. Sie sind vom Typ wchar_t (siehe stddef.h). (Ende)
Returnwert	nicht negative Zahl
		bei erfolgreicher Beendigung.
	-1	bei Fehler, z.B. wenn der Datenstrom nicht gepuffert ist oder Daten im Puffer von stream geschrieben werden müssen. Das Fehlerkennzeichen für den Datenstrom wird gesetzt. errno wird gesetzt, um den Fehler anzuzeigen
Fehler	Siehe fputwc().
Hinweise	fputws() hängt kein Zeilenendezeichen an. BS2000 Bei Textdateien mit der Zugriffsart SAM und variabler Satzlänge, für die zusätzlich eine maximale Satzlänge angegeben ist, gilt: Wenn bei fopen() die Angabe split=no gemacht wurde, werden Sätze, die länger als die maximale Satzlänge sind, beim Schreiben auf die maximale Satzlänge gekürzt. Standardmäßig oder mit der Angabe split=yes werden diese Sätze in mehrere Sätze aufgeteilt. Hat ein Satz genau die maximale Satzlänge, wird nach diesem ein Satz der Länge Null geschrieben. (Ende)
Siehe auch	fopen(), fputwc(), stdio.h, sys/stat.h, wchar.h.