fputwc, putwc

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Datei-Ein-/Ausgabe

Typen und Objekte
stdinstdoutstderr          FILE fpos_t
Funktionen Datei-Zugriff fopenfopen_s (C11) freopenfreopen_s (C11)   fwide (C95) setbuf setvbuf fclose fflush Unformatierte Ein-/Ausgabe fgetc fgets fputc fputs getchar getsgets_s (bis C11)(C11) putchar puts ungetc fgetwcgetwc (C95)(C95) fgetws (C95) fputwcputwc (C95)(C95) fputws (C95) getwchar (C95) putwchar (C95) ungetwc (C95) Formatierte Eingabe scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11) wscanffwscanfswscanfwscanf_sfwscanf_sswscanf_s (C95)(C95)(C95)(C11)(C11)(C11) vscanfvfscanfvsscanfvscanf_svfscanf_svsscanf_s (C99)(C99)(C99)(C11)(C11)(C11) vwscanfvfwscanfvswscanfvwscanf_svfwscanf_svswscanf_s (C99)(C99)(C99)(C11)(C11)(C11)	Direkte Ein-/Ausgabe fread fwrite Formatierte Ausgabe printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11) wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11)   vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (C99)(C11)(C11)(C11)(C11) vwprintfvfwprintfvswprintfvwprintf_svfwprintf_svswprintf_svsnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11) Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove tmpfiletmpfile_s (C11) rename tmpnamtmpnam_s (C11)

 

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 Wide-Zeichen ch in den gegebenen Ausgabestrom stream.

2) Kann als Makro implementiert sein und kann stream mehr als einmal auswerten.

Parameter

ch	-	zu schreibendes Weitzeichen
stream	-	der Ausgabestrom

Rückgabewert

Gibt bei Erfolg eine Kopie von ch zurück.

Bei einem Fehler wird WEOF zurückgegeben und der Fehlerindikator (siehe ferror()) für stream gesetzt.

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

Beispiel

Führen Sie diesen Code aus

#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

fputcputc	schreibt ein Zeichen in einen Dateistream (Funktion)
fputws (C95)	schreibt einen Weitzeichenstring in einen Dateistream (Funktion)
fgetwcgetwc (C95)	liest ein Weitzeichen aus einem Dateistream (Funktion)
C++-Dokumentation für fputwc