4D Doc Center : ARRAY TEXT

4D v13.4

ARRAY TEXT


ARRAY TEXT ( nomeArray ; tamanho {; tamanho2} )

Parâmetro	Tipo	Descrição
nomeArray	Array	Nome do array
tamanho	Inteiro longo	Número de elementos no array ou Número de linhas se tamanho 2 for especificado
tamanho2	Inteiro longo	Número de colunas no array de duas dimensões

Descrição

O comando ARRAY TEXT cria e/ou redimensiona um array de elementos do tipo Texto na memória.

O parâmetro nomeArray é o nome do array.
O parâmetro tamanho é o número de elementos em um array.
O parâmetro tamanho2 é opcional; se tamanho2 for especificado, o comando cria um array de duas dimensões. Neste caso, tamanho especifica o número de linhas e tamanho2 especifica o número de colunas em cada array. Cada linha em um array de duas dimensões pode ser tratada tanto como um elemento como um array. Isso significa que enquanto se trabalha com a primeira dimensão do array, você pode usar outros comandos de array para inserir e deletar arrays inteiros e arrays de duas dimensões.

Enquanto se aplica ARRAY TEXT para um array já existente:

se você aumentar o tamanho de um array, os elementos existentes não sofrem mudanças, e os novos elementos se iniciam em "" (cadeia vazia).
se você reduzir o tamanho de um array, os últimos elementos deletados do array se perdem.

Exemplo 1

Este exemplo cria um array de processo de 100 elementos de tipo Texto:

ARRAY TEXT(atValores;100)

Exemplo 2

Este exemplo cria um array local de 100 linhas de 50 elementos do tipo Texto:

ARRAY TEXT($atValores;100;50)

Exemplo 3

Este exemplo cria um array de interprocesso de elementos do tipo texto e atribui a cada elemento o valor “Elemento #” seguido pelo seu número de elemento:

 ARRAY TEXT(◊atValues;50)

 For($vlElem;1;50)

    ◊atValores{$vlElem}:="Elemento #"+String($vlElem)

 End for