Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

wcslen — délka řetězce širokých znaků

wcslen z <wchar.h> vrací počet prvků wchar_t před prvním nulovým širokým znakem; tento ukončovací znak se nezapočítává.

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

Syntaxe

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

wcslen(s) vrací délku řetězce širokých znaků jako size_t. Počítá prvky wchar_t, nikoli bajty ani znaky vnímané uživatelem. Neměří kapacitu pole.

s musí ukazovat na platný řetězec širokých znaků ukončený nulovým znakem. Předání NULL nebo chybějící ukončovací znak v dostupném poli způsobuje nedefinované chování; funkce nepřijímá limit čtení.

V příkladu obsahuje L"cat\0dog" vnitřní ukončovací znak, takže výsledkem je 3. Převod %zu vypíše hodnotu typu size_t.

Příklady

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

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

Výsledek

3

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje