mbrtowc

Konvertiert ein schmales Multibyte-Zeichen in seine Breitzeichen-Darstellung.

Wenn s kein Nullzeiger ist, untersucht die Funktion bis zu n Bytes der Multibyte-Zeichenkette, beginnend mit dem von s gezeigten Byte, um die Anzahl der Bytes zu bestimmen, die notwendig sind, um das nächste Multibyte-Zeichen abzuschließen (einschließlich aller Shift-Sequenzen und unter Berücksichtigung des aktuellen Multibyte-Konvertierungszustands * ps ). Wenn die Funktion feststellt, dass das nächste Multibyte-Zeichen in s vollständig und gültig ist, konvertiert sie es in das entsprechende Breitzeichen und speichert es in * pwc (falls pwc nicht null ist).

Wenn s ein Nullzeiger ist, werden die Werte von n und pwc ignoriert und der Aufruf entspricht mbrtowc ( NULL , "" , 1 , ps ) .

Wenn das erzeugte Breitzeichen das Nullzeichen ist, ist der in * ps gespeicherte Konvertierungszustand der anfängliche Schaltzustand.

Falls das Umgebungsmakro __STDC_ISO_10646__ definiert ist, entsprechen die Werte des Typs wchar_t den Kurzidentifikatoren der Zeichen des Unicode-Pflichtzeichensatzes (typischerweise UTF-32-Kodierung); andernfalls ist dies implementierungsdefiniert. In jedem Fall wird die von dieser Funktion verwendete Multibyte-Zeichenkodierung durch die aktuell aktive C-Locale festgelegt.

Parameter

Rückgabewert

Das erste der folgenden zutreffenden Kriterien:

• ​ 0 ​ wenn das von s konvertierte Zeichen (und gespeichert in pwc falls nicht null) das Nullzeichen war
• die Anzahl der Bytes [ 1 ... n ] des Multibyte-Zeichens, das erfolgreich von s konvertiert wurde
• ( size_t ) - 2 wenn die nächsten n Bytes ein unvollständiges, aber bisher gültiges Multibyte-Zeichen darstellen. Nichts wird nach * pwc geschrieben.
• ( size_t ) - 1 wenn ein Kodierungsfehler auftritt. Nichts wird nach *pwc geschrieben, der Wert EILSEQ wird in errno gespeichert und der Wert von * ps bleibt unbestimmt.

Beispiel

#include <stdio.h>
#include <locale.h>
#include <string.h>
#include <wchar.h>
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    mbstate_t state;
    memset(&state, 0, sizeof state);
    char in[] = u8"z\u00df\u6c34\U0001F34C"; // or u8"zß水🍌"
    size_t in_sz = sizeof in / sizeof *in;
    printf("Processing %zu UTF-8 code units: [ ", in_sz);
    for(size_t n = 0; n < in_sz; ++n) printf("%#x ", (unsigned char)in[n]);
    puts("]");
    wchar_t out[in_sz];
    char *p_in = in, *end = in + in_sz;
    wchar_t *p_out = out;
    int rc;
    while((rc = mbrtowc(p_out, p_in, end - p_in, &state)) > 0)
    {
        p_in += rc;
        p_out += 1;
    }
    size_t out_sz = p_out - out + 1;
    printf("into %zu wchar_t units: [ ", out_sz);
    for(size_t x = 0; x < out_sz; ++x) printf("%#x ", out[x]);
    puts("]");
}

Processing 11 UTF-8 code units: [ 0x7a 0xc3 0x9f 0xe6 0xb0 0xb4 0xf0 0x9f 0x8d 0x8c 0 ]
into 5 wchar_t units: [ 0x7a 0xdf 0x6c34 0x1f34c 0 ]

Referenzen