CKTIS / C
wcslen — comprimento de uma cadeia de caracteres largos
wcslen de <wchar.h> devolve o número de elementos wchar_t antes do primeiro carácter largo nulo, sem incluir esse terminador.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <wchar.h>
size_t wcslen(const wchar_t *s);wcslen(s) devolve o comprimento de uma cadeia de caracteres largos como size_t. Conta elementos wchar_t, não bytes nem caracteres percecionados pelo utilizador. Não mede a capacidade do array.
s tem de apontar para uma cadeia válida de caracteres largos terminada em nulo. Passar NULL ou não ter o terminador dentro do array acessível causa comportamento indefinido; a função não aceita um limite de leitura.
No exemplo, L"cat\0dog" contém um terminador interno, pelo que o resultado é 3. A conversão %zu imprime um valor do tipo size_t.
Exemplos
#include <stdio.h>
#include <wchar.h>
int main(void)
{
const wchar_t text[] = L"cat\0dog";
printf("%zu\n", wcslen(text));
return 0;
}Resultado
3
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.