mbrlen

Bestimmt die Größe in Bytes der Darstellung eines Multibyte-Zeichens.

Diese Funktion entspricht dem Aufruf mbrtowc ( NULL , s, n, ps ? ps : & internal ) für ein verborgenes Objekt internal vom Typ mbstate_t , mit der Ausnahme, dass der Ausdruck ps nur einmal ausgewertet wird.

Parameter

Rückgabewert

Das erste der folgenden zutreffenden Kriterien:

• ​ 0 ​ wenn die nächsten n oder weniger Bytes das Nullzeichen vervollständigen oder wenn s ein Nullzeiger ist. Beide Fälle setzen den Konvertierungszustand zurück.
• die Anzahl der Bytes [ 1 ... n ] die ein gültiges Multibyte-Zeichen vervollständigen
• ( size_t ) - 2 wenn die nächsten n Bytes Teil eines möglicherweise gültigen Multibyte-Zeichens sind, das nach Überprüfung aller n Bytes noch unvollständig ist
• ( size_t ) - 1 wenn ein Kodierungsfehler auftritt. Der Wert von errno ist EILSEQ ; der Konvertierungszustand ist nicht spezifiziert.

Beispiel

#include <locale.h>
#include <stdio.h>
#include <string.h>
#include <wchar.h>
int main(void)
{
    // ermöglicht mbrlen() mit UTF-8 Multibyte-Kodierung zu arbeiten
    setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 schmale Multibyte-Kodierung
    const char* str = "水";
    size_t sz = strlen(str);
    mbstate_t mb;
    memset(&mb, 0, sizeof mb);
    int len1 = mbrlen(str, 1, &mb);
    if (len1 == -2)
        printf("Die ersten 1 Byte von %s bilden ein unvollständiges Multibyte-Zeichen"
               " (mbrlen gibt -2 zurück)\n", str);
    int len2 = mbrlen(str + 1, sz - 1, &mb);
    printf("Die verbleibenden %zu Bytes von %s enthalten %d Bytes des Multibyte-"
           "Zeichens\n", sz - 1, str, len2);
    printf("Der Aufruf von mbrlen() mitten in %s im initialen Schaltzustand gibt %zd zurück\n", str, mbrlen(str + 1, sz - 1, &mb));
}

Die ersten 1 Byte von 水 bilden ein unvollständiges Multibyte-Zeichen (mbrlen gibt -2 zurück)
Die verbleibenden 2 Bytes von 水 enthalten 2 Bytes des Multibyte-Zeichens
Der Aufruf von mbrlen() mitten in 水 im initialen Schaltzustand gibt -1 zurück

Referenzen

Siehe auch