fgetws - Langzeichenkette aus einer Datei lesen

Definition	#include <wchar.h> #include <stdio.h> wchar_t * fgetws(wchar_t *ws, int n, FILE *dz); fgetws liest Zeichen aus der Datei mit dem Dateizeiger dz, wandelt sie in die entsprechenden Langzeichenwerte um und legt sie im Vektor ws vom Typ wchar_t ab. fgetws liest maximal n-1 Zeichen bis einschließlich einem Zeilenendezeichen oder bis zum Dateiende. Die Langzeichenkette ws wird mit einem Nullbyte-Langzeichen abgeschlossen. Wenn ein Fehler auftritt, ist der Wert des Lese-/Schreibzeigers für die Datei nicht definiert.
Returnwert	Zeiger auf die Ergebnis-Langzeichenkette ws
		bei Erfolg
	NULL-Zeiger	wenn das Dateiende erreicht wird; das Dateiendekennzeichen für die Datei wird gesetzt wenn ein Lesefehler auftritt; die Fehleranzeige für die Datei wird gesetzt  errno wird auf EBADF gesetzt, wenn dz kein gültiger Dateizeiger ist.
Hinweise	In dieser Version des C-Laufzeitsystems werden nur 1-Byte-Zeichen als Langzeichen unterstützt. 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 maximaler Länge beim Lesen nicht mit dem darauffolgenden Satz verkettet. Standardmäßig oder mit der Angabe split=yes wird beim Lesen eines Satzes mit maximaler Satzlänge angenommen, dass es sich bei dem Folgesatz um die Fortsetzung dieses Satzes handelt, und die Sätze werden verkettet.
Siehe auch	fgetwc, fopen, fopen64, fread