fgetws(3S)                                                       fgetws(3S)

NAME
     fgetws - Wide-Character-Zeichenkette vom Stream lesen

SYNTAX
     cc [option ...] datei ... -lw [bibliothek ...]

     #include <stdio.h>
     #include <wchar.h>

     wchart *fgetws(wchart *ws, int n, FILE *stream);

BESCHREIBUNG
     Die Funktion fgetws() liest Zeichen vom stream, wandelt sie in die
     entsprechenden Wide-Character-Werte um und legt sie im Feld vom Typ
     wchart ab, auf das ws zeigt, bis n-1 Zeichen gelesen wurden, ein
     Neue-Zeile-Zeichen gelesen, konvertiert und an ws übertragen wird bzw.
     eine Dateiende-Bedingung angetroffen wird. Die Zeichenkette aus Wide-
     Character-Werten, ws, wird mit einem Nullbyte abgeschlossen.

     Wenn ein Fehler auftritt, ist der Wert des Schreib-/Lesezeigers für
     den Stream nicht definiert.

     Die Funktion fgetws() kann das Feld statime der Datei, die stream
     geordnet ist, zur Aktualisierung kennzeichnen. Das Feld statime
     erhält eine Kennzeichnung zur Aktualisierung durch die erste erfolg-
     reiche Ausführung von fgetc(), fgets(), fgetwc(), fgetws(), fread(),
     getc(), getchar(), gets() oder scanf() mit stream, die Daten zurück-
     gibt, die nicht von einem vorherigen Aufruf von ungetc() oder
     ungetwc() geliefert werden.

     Die Funktion fgetws() schlägt fehl, wenn Daten gelesen werden müssen
     und:

     EAGAIN      Das Flag ONONBLOCK wird für den stream zugrundeliegenden
                 Dateideskriptor gesetzt. Es tritt für den Prozeß eine Ver-
                 zögerung bei der Operation fgetwc() ein.

     EBADF       Der dem Stream zugrundeliegende Dateideskriptor ist kein
                 gültiger Dateideskriptor, der für das Lesen geöffnet ist.

     EINTR       Die Leseoperation wurde aufgrund des Empfangs eines Sig-
                 nals beendet. Es wurden keine Daten übertragen.

     EIO         Der Prozeß ist in einer Hintergrund-Prozeßgruppe, die ver-
                 sucht, vom steuernden Terminal zu lesen. Der Prozeß igno-
                 riert oder blockiert das Signal SIGTTIN, oder die Prozeß-
                 gruppe ist verwaist. Dieser Fehler kann auch aus implemen-
                 tationsabhängigen Gründen generiert werden.







Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

fgetws(3S)                                                       fgetws(3S)

     EOVERFLOW   Die Datei ist eine reguläre Datei, und es wurde versucht,
                 Daten am oder nach dem Offset-Maximum zu lesen, das dem
                 zugehörigen Stream zugeordnet ist.

     Die Funktion fgetws() kann fehlschlagen, wenn:

     ENOMEM      Nicht genügend Speicher verfügbar.

     ENXIO       Anforderung eines nicht existierenden Geräts bzw. Anforde-
                 rung jenseits der Leistungsgrenzen des Geräts.

     EILSEQ      Die Daten vom Eingabe-Stream ergeben kein gültiges Zei-
                 chen.

ERGEBNIS
     Bei erfolgreicher Beendigung gibt die Funktion fgetws() ws zurück.
     Wenn der Stream am Dateiende angelangt ist, wird die Dateiende-Anzeige
     für den Stream gesetzt. fgetws() gibt einen Nullzeiger zurück. Wenn
     ein Lesefehler auftritt, wird die Fehleranzeige für den Stream
     gesetzt, fgetws() gibt einen Nullzeiger zurück und setzt errno auf den
     Fehler.

SIEHE AUCH
     fopen(3S), fread(3S), lfs(5), wchar(5).






























Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98