TOTVSTEC

Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

Versão 1 Atual »

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
  • Sem rótulos