WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

wcrtomb — ein Wide-Zeichen in eine Multibyte-Sequenz umwandeln

wcrtomb kodiert ein wchar_t gemäß LC_CTYPE und bewahrt den Konvertierungszustand in mbstate_t.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <wchar.h>
size_t wcrtomb(char * restrict s, wchar_t wc, mbstate_t * restrict ps);

wcrtomb schreibt wc gemäß LC_CTYPE; das Ergebnis ist nicht unbedingt UTF-8. Der Puffer muss MB_CUR_MAX Bytes aufnehmen können; MB_LEN_MAX reicht für jedes Locale aus.

Initialisiere mbstate_t mit {0} und behalte den Zustand zwischen Zeichen bei. Bei ps == NULL wird ein interner Zustand verwendet.

Der Rückgabewert gibt die Anzahl der geschriebenen Bytes an, einschließlich Schaltsequenzen. Bei einem Fehler wird (size_t)-1 zurückgegeben, errno auf EILSEQ gesetzt und der Zustand bleibt unbestimmt.

L'\0' schreibt ein Nullbyte und stellt den Anfangszustand wieder her. Andere Zeichen fügen keinen Abschluss hinzu. Bei s == NULL wird wc ignoriert: L'\0' wird in einen internen Puffer umgewandelt, statt die Länge zu messen.

Beispiele

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

int main(void)
{
    if (setlocale(LC_CTYPE, "C") == NULL)
        return 1;

    mbstate_t state = {0};
    char buffer[MB_LEN_MAX];
    size_t n = wcrtomb(buffer, L'A', &state);
    if (n == (size_t)-1)
        return 1;
    printf("bytes=%zu, matches=%d\n", n,
           n == 1 && buffer[0] == 'A');
    return 0;
}

Ergebnis

bytes=1, matches=1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen