Páginas filhas
  • _ADVPL_arrayToStrToken

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Nome

Tipo

Obrigatório?

Descrição

aArray

ARRAY OF RECORD
ou
ARRAY OF <TYPE>

Sim

Variável 4GL do tipo ARRAY ou ARRAY OF RECORD onde será feita exportação de seu conteúdo para um CHAR.

cToken

CHAR

Não

Caracter ou conjunto de caracteres que serão utilizados para delimitar os valores de cada linha e/ou elemento da lista (Array) para um conteúdo no formato texto (Char).
O valor padrão assumido quando não for informado, será o conteúdo em branco/vazio.

lClippedValues

BOOLEAN

Não

Permite indicar se todos os conteúdos deverão ter seus espaços em branco encontrados a direita de cada valor deverão ser suprimidos ou não.
O valor padrão assumido quando não for informado será TRUE, suprimindo os espaços em branco a direita do conteúdo de cada valor da lista/array.

Valores:

      TRUE  (4gl) - Suprimir os espaços em branco à direita dos valores da lista/array na montagem do conteúdo texto.
      FALSE (4gl) - Manter os espaços em branco à direita dos valoes da lista/array na montagem do conteúdo texto.

Retorno

Tipo

Descrição

CHAR

Conteúdo completo de todo array, no formato de um texto, respeitando o delimitador, quando informado

INTEGER

Posição do ARRAY onde a informação foi encontrada. Retornará 0 (zero) caso não encontre.

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
DEFINE ma_dados ARRAY[3] OF CHAR(50)
                            
#------------------------------#
 FUNCTION arrayToStrToken_test()
#------------------------------#
  DEFINE l_texto VARCHAR(200)

  LET ma_dados[1] = 'linha 01'
  LET ma_dados[2] = 'linha 03'
  LET ma_dados[3] = 'linha 02'
 
  ### Transferir os dados das linhas do array para um CHAR delimitando o conteúdo com uma quebra de linha (caracter \n)
  LET l_texto = _ADVPL_arrayToStrToken(ma_dados,"\n")

  CALL conout("Conteúdo gerado no LOG do Appserver com a função ArrayToStrToken():",l_texto)
END FUNCTION

...