Retorna o tamanho de uma cadeia de caracteres ou a quantidade de elementos em um array.
Sintaxe
Len( < xParam > )
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
---|---|---|---|---|
xParam | qualquer | Variável que será avaliada | X |
|
Retorno
Nome | Tipo | Descrição |
---|---|---|
nCount | numérico | Retorna o tamanho do array ou do String. |
Observações
- Se a cadeia de caracteres especificada for nula (“”), a função LEN() retornará o valor zero. Entretanto, o caracter nulo, CHR(0), tem o comprimento de uma (1) posição.
- Deve-se lembrar que no AdvPL cada array multidimensional e composto por vários subarrays. Além disso, estes subarrays não precisam, necessariamente, ter dimensões uniformes.
Exemplos
Exemplo 1
User function exemplo() MsgAlert( LEN(AdvPL) ) // Resulta 5 cNome := Protheus ERP da TOTVS MsgAlert( LEN(cNome) ) // Resulta 23 MsgAlert( LEN() ) // Resulta zero MsgAlert( LEN(CHR(0)) ) // Resulta 1 Return //O exemplo abaixo demonstra como obter o número de elementos de um array com várias dimensões: User Function exemplo2() LOCAL aMatriz[5, 10, 5] MsgAlert( LEN(aMatriz) ) // Resulta 5, o número de elementos da primeira dimensão MsgAlert( LEN(aMatriz[1]) ) // Resulta 10, o número de elementos da segunda dimensão MsgAlert( LEN(aMatriz[1, 1]) ) // Resulta 5, o número de elementos da terceira dimensão // Resulta 250, o número total de elementos do array MsgAlert( LEN(aMatriz) * LEN(aMatriz[1]) * LEN(aMatriz[1, 1]) ) Return
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas