fputws(3S)                                                       fputws(3S)

NAME
     fputws - Wide-Character-Zeichenkette auf Stream schreiben

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

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

     int fputws(const wchart *ws, FILE *stream);

BESCHREIBUNG
     Die Funktion fputws() schreibt eine Zeichenkette entsprechend der (mit
     einem Nullbyte abgeschlossenen) Zeichenkette aus Wide-Character-
     Werten, auf die ws zeigt, auf den Stream, auf den stream zeigt. Es
     wird kein Zeichen geschrieben, das dem abschließenden Nullbyte ent-
     spricht.

     Die Funktion fputws() hängt kein Neue-Zeile-Zeichen an.

     Die Felder stctime und stmtime der Datei werden zwischen der erfolg-
     reichen Ausführung von fputws() und der nächsten erfolgreichen Beendi-
     gung eines Aufrufs von fflush() oder fclose() auf dem gleichen Stream
     oder einem Aufruf von exit() oder abort()zur Aktualisierung gekenn-
     zeichnet.

FEHLER
     Die folgenden Beschreibungen der Fehlercodes sind funktionsspezifisch.
     Eine allgemeingültige Beschreibung finden Sie in introprm2(2) bzw. in
     errno(5).

     Die Funktion fputws() schlägt fehl, wenn der Stream nicht gepuffert
     ist oder Daten im Puffer des streams geschrieben werden müssen und:

     EAGAIN    Das Flag ONONBLOCK wird für den stream zugrundeliegenden
               Dateideskriptor gesetzt. Es tritt für den Prozeß eine Verzö-
               gerung bei der Schreiboperation ein.

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

     EFBIG     Es wurde versucht, in eine Datei zu schreiben, die die maxi-
               male Dateigröße oder die Dateigrößenbegrenzung des Prozesses
               überschreitet [siehe ulimit(2)].

     EFBIG     Die Datei ist eine reguläre Datei, und es wurde versucht,
               Daten am oder über das Offset-Maximum hinaus zu schreiben,
               das dem zugehörigen Stream zugeordnet ist.

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



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

fputws(3S)                                                       fputws(3S)

     EIO       Der Prozeß ist Teil einer Hintergrund-Prozeßgruppe, die ver-
               sucht, auf das steuernde Terminal zu schreiben. TOSTOP wird
               gesetzt, weder ignoriert noch blockiert der Prozeß SIGTOU,
               und die Prozeßgruppe des Prozesses ist verwaist. Dieser Feh-
               ler kann auch aus implementationsabhängigen Gründen gene-
               riert werden.

     ENOSPC    Kein freier Bereich auf dem Gerät, das die Datei enthält.

     EPIPE     Es wird versucht, in eine Pipe oder FIFO zu schreiben, die
               für keinen Prozeß zum Lesen geöffnet ist. Ein Signal SIGPIPE
               wird auch an den Prozeß gesendet.

     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    Der Wide-Character-Wert wc entspricht keinem gültigen Zei-
               chen.

ERGEBNIS
     Bei erfolgreicher Beendigung gibt die Funktion fputws() eine nicht
     negative Zahl zurück. Andernfalls wird -1 zurückgegeben, die Fehleran-
     zeige für den Stream gesetzt, und errno wird auf den Fehler gesetzt.

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
























Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98