Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes