Histórico da Página

cText

CHAR

Sim

Texto de origem para ter seu conteúdo dividido em partes, de acordo com um delimitador.

a4GLReturnArray

ARRAY OF CHAR

Sim

Nome da variável 4GL do tipo ARRAY OF CHAR que irá receber a atribuição dos valores resultantes da divisão do conteúdo do parâmetor cText, respeitando a cadeia de caracteres indicada como delimitador.

Este parâmetro deverá ser uma variável do tipo ARRAY SIMPLESsimples, ou seja, na linguagem 4GL ela é definida como ARRAY OF CHAR. Assim sendo, não deve-se utilizar aqui um parâmetro que seja, por exemplo, ARRAY OF RECORD.

O array pode ou não ter uma quantidade de linhas na sua definição, no entanto a função sempre irá eliminar todas suas linhas e o retorno sempre será um ARRAY na com a quantidade de linhas correspondente a quantidade de ocorrências encontradas, conforme o delimitador de valores informado.

Exemplo:
DEFINE    DEFINE la_values ARRAY[] OF CHAR(300)

cToken

CHAR

Sim

Um caracter ou uma sequência de caracteres que é reconhecido como o delmitador dos valores contidos no parâmetro cText.