Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

wcslen — długość łańcucha szerokich znaków

wcslen z <wchar.h> zwraca liczbę elementów wchar_t przed pierwszym szerokim znakiem zerowym, bez wliczania terminatora.

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

Składnia

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

wcslen(s) zwraca długość łańcucha szerokich znaków jako size_t. Liczy elementy wchar_t, nie bajty ani znaki postrzegane przez użytkownika. Nie mierzy pojemności tablicy.

s musi wskazywać na poprawny łańcuch zakończony szerokim znakiem zerowym. Przekazanie NULL albo brak terminatora w dostępnej tablicy powoduje niezdefiniowane zachowanie; funkcja nie przyjmuje limitu odczytu.

W przykładzie L"cat\0dog" zawiera wewnętrzny terminator, więc wynikiem jest 3. Specyfikator %zu służy do wypisania wartości size_t.

Przykłady

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

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

Wynik

3

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła