Len
Tamanho de array, string ou objeto colecionavel. Funcao mais usada do AdvPL.
Assinatura: Len(xValor) -> nTam
Retorna: Numeric
Len e a funcao mais usada de AdvPL. Retorna o tamanho de:
- Array — numero de elementos
- String — numero de caracteres
- JsonObject (TLPP) — numero de chaves
Len({1,2,3}) // 3
Len("Protheus") // 8
Len("") // 0
// Loop classico
For i := 1 To Len(aArr)
ConOut(aArr[i])
Next
Pegadinhas
- Sem trim implicito —
Len("AAA ")= 6 (conta espacos a direita). - Em loop apertado, calcular Len() a cada iteracao tem custo. Em arrays gigantes (50k+), cache em variavel.
- NIL retorna 0 — nao excecao.
- Pra strings AdvPL legacy, considere se quer Len com ou sem padding.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
xValor | Any | sim | Array, string ou JsonObject. |