Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

Len

Len( <xValor> )

Retorna o tamanho de uma string ou a quantidade de elementos de um array.

StringsArraysTamanho
01 · VISÃO GERAL

Visão geral

Len() é usada para medir o comprimento de textos e a quantidade de elementos de arrays. Embora o material de referência destaque strings, no uso diário de AdvPL ela também é essencial para percorrer arrays com FOR ... NEXT.

02 · SINTAXE

Sintaxe

Len( <xValor> )

Parâmetros

xValor
Caractere ou ArrayObrigatório

Texto ou array cujo tamanho será consultado.

03 · EXEMPLO PRÁTICO

Tamanho de texto e array

User Function ExLen()
    Local cNome := "Cliente"
    Local aItens := {"A", "B", "C"}

    MsgInfo("Texto: " + CValToChar(Len(cNome)))
    MsgInfo("Itens: " + CValToChar(Len(aItens)))
Return
Resultado esperado

Len(cNome) retorna o tamanho do texto e Len(aItens) retorna a quantidade de elementos do array.

BOAS PRÁTICAS
  • Use Len(aArray) ao percorrer arrays.
  • Para strings de campos fixos, combine com AllTrim() quando quiser ignorar espaços laterais.
ARMADILHAS COMUNS
  • Len(cCampo) conta espaços existentes no texto.
  • Não confunda Len() com Count(): Len() mede texto/array em AdvPL; Count() é usado em outros contextos, como SQL.

Conteúdos relacionados

REFERÊNCIAS
  1. Programação em ADVPL Completo. Documentação oficial histórica de treinamento, seção 4.5.4, p. 45-50. Conteúdo resumido, revisado e exemplos adaptados.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha