Namespaces
Variants

fputwc, putwc

Aus de.cppreference.net
< C | E/A
 
 
Datei-Ein-/Ausgabe
Typen und Objekte
        
Funktionen
Dateizugriff
(C95)
Unformatierte Ein-/Ausgabe
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)

Formatierte Eingabe
Direkte Ein-/Ausgabe
Formatierte Ausgabe
Dateipositionierung
Fehlerbehandlung
Operationen auf Dateien
 
Definiert in Header <wchar.h>
wint_t fputwc( wchar_t ch, FILE* stream );
(1) (seit C95)
wint_t putwc( wchar_t ch, FILE* stream );
(2) (seit C95)

Schreibt ein Breitzeichen ch in den gegebenen Ausgabestrom stream.

2) Kann als Makro implementiert sein und darf stream mehrfach auswerten.

Parameter

ch - zu schreibendes Breitzeichen
stream - der Ausgabestrom

Rückgabewert

Gibt eine Kopie von ch bei Erfolg zurück.

Bei Fehler wird WEOF zurückgegeben und das Fehlerkennzeichen gesetzt (siehe ferror()) auf stream.

Wenn ein Kodierungsfehler auftritt, wird zusätzlich errno auf EILSEQ gesetzt.

Beispiel

#include <errno.h>
#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>

int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");

    errno = 0;
    if (fputwc(L'🍌', stdout) == WEOF)
    {
        if (errno == EILSEQ)
            puts("Encoding error in fputwc.");
        else
            puts("I/O error in fputwc.");
        return EXIT_FAILURE;
    }
}

Mögliche Ausgabe:

🍌

Referenzen

  • C23-Standard (ISO/IEC 9899:2024):
  • 7.31.3.3 Die Funktion fputwc (S. 430)
  • 7.31.3.8 Die Funktion putwc (S. 431‑432)
  • C17-Standard (ISO/IEC 9899:2018):
  • 7.29.3.3 Die Funktion fputwc (S. 308)
  • 7.29.3.8 Die Funktion putwc (S. 310)
  • C11-Standard (ISO/IEC 9899:2011):
  • 7.29.3.3 Die Funktion fputwc (S. 422‑423)
  • 7.29.3.8 Die Funktion putwc (S. 424)
  • C99-Standard (ISO/IEC 9899:1999):
  • 7.24.3.3 Die Funktion fputwc (S. 368)
  • 7.24.3.8 Die Funktion putwc (S. 370)

Siehe auch

schreibt ein Zeichen in einen Dateistrom
(Funktion)
(C95)
schreibt eine Breitzeichenkette in einen Dateistrom
(Funktion)
liest ein Breitzeichen aus einem Dateistrom
(Funktion)
C++-Dokumentation für fputwc