_ADVPL_arrayToStrToken

Permite exportar todo conteúdo de um array para um conteúdo texto (String), indicando um caracter ou conjunto de caracteres para delimitar ou não os valores.

Sintaxe

_ADVPL_arrayToStrToken( < aArray > , [ < cToken > ] , [ < lClippedValues > ] ) => CHAR

Parâmetros

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.

Exemplo

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

Informações

Fontes: array.prw

Observações

Disponível a partir do pacote Logix 12.1.2507 ou FIX Framework 12.1.2503.fix01.

Páginas filhas