WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

wcslen — Länge einer Wide-Character-Zeichenkette

wcslen aus <wchar.h> gibt die Anzahl der wchar_t-Elemente vor dem ersten Null-Wide-Character zurück, ohne diesen Abschluss einzurechnen.

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

Syntax

#include <wchar.h>
size_t wcslen(const wchar_t *s);

wcslen(s) gibt die Länge einer Wide-Character-Zeichenkette als size_t zurück. Die Funktion zählt wchar_t-Elemente, nicht Bytes oder vom Menschen wahrgenommene Zeichen. Sie misst nicht die Kapazität des Arrays.

s muss auf eine gültige, nullterminierte Wide-Character-Zeichenkette zeigen. Die Übergabe von NULL oder ein fehlender Abschluss innerhalb des zugänglichen Arrays führt zu undefiniertem Verhalten; die Funktion akzeptiert keine Lesegrenze.

Im Beispiel enthält L"cat\0dog" einen eingebetteten Abschluss, daher ist das Ergebnis 3. Die Konvertierung %zu gibt einen Wert vom Typ size_t aus.

Beispiele

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

int main(void)
{
    const wchar_t text[] = L"cat\0dog";
    printf("%zu\n", wcslen(text));
    return 0;
}

Ergebnis

3

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