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.