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⟩.