fputwc(3)

BEZEICHNUNG
fputwc, putwc - Ein weites Zeichen in einen FILE-Datenstrom schreiben

BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)

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

wint_t fputwc(wchar_t wz, FILE *Datenstrom);
wint_t putwc(wchar_t wz, FILE *Datenstrom);

BESCHREIBUNG
Die Funktion fputwc() ist das Äquivalent der Funktion fputc(3) für weite Zeichen. Sie schreibt das weite Zeichen wz in Datenstrom. Falls ferror(Datenstrom) wahr wird, liefert sie WEOF zurück. Falls ein Fehler bei der Umwandlung in weite Zeichen auftritt, setzt sie errno auf EILSEQ und liefert WEOF zurück. Andernfalls liefert sie wz zurück.

Die Funktion oder das Makro putwc() funktionieren identisch zu fputwc(). Sie kann als Makro implementiert sein und wertet ihre Argumente mehrfach aus. Es gibt keinen Grund, sie jemals zu verwenden.

Für nicht sperrende Gegenstücke siehe unlocked_stdio(3).

RÜCKGABEWERT
Im Erfolgsfall liefert die Funktion fputwc() wz zurück. Andernfalls wird WEOF zurückgeliefert und errno gesetzt, um den Fehler anzuzeigen.

FEHLER
Abgesehen von den normalen gibt es

EILSEQ
    Umwandlung von wz in die Kodierung des Datenstroms schlägt fehl.

ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
Schnittstelle | Attribut | Wert
fputwc(), putwc() | Multithread-Fähigkeit | MT-Sicher

STANDARDS
C11, POSIX.1-2008.

GESCHICHTE
C99, POSIX.1-2001.

ANMERKUNGEN
Das Verhalten von fputwc() hängt von der Kategorie LC_CTYPE der aktuellen Locale ab.

Da keine zusätzlichen Informationen an den Aufruf fopen(3) übergeben werden, kann vernünftigerweise erwartet werden, dass fputwc() tatsächlich die Multibyte-Sequenz, die dem weiten Zeichen wz entspricht, schreibt.

SIEHE AUCH
fgetwc(3), fputws(3), unlocked_stdio(3)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.