ARRAY TEXT

4D v20 R7

ARRAY TEXT


ARRAY TEXT ( nombreArray ; tamaño {; tamaño2} )

Parámetro	Tipo	Descripción
nombreArray	Array	Nombre del array
tamaño	Entero largo	Número de elementos en el array o Número de filas si se especifica tamaño2
tamaño2	Entero largo	Número de columnas en un array bidimensional

Descripción

El comando ARRAY TEXT crea y/o redimensiona un array de elementos de tipo Texto en memoria.

El parámetro nombreArray es el nombre del array.
El parámetro tamaño es el número de elementos en el array.
El parámetro tamaño2 es opcional; si se especifica tamaño2, el comando crea un array bidimensional. En este caso, tamaño especifica el número de filas y tamaño2 especifica el número de columnas en cada array. Cada fila en un array bidimensional puede tratarse como un elemento y como un array. Esto significa que mientras trabaja con la primera dimensión del array, puede utilizar otros comandos de array para insertar y borrar arrays enteros en un array bidimensional.

Cuando aplica ARRAY TEXT a un array existente:

Si agranda el tamaño del array, los elementos existentes no se modifican, y los nuevos elementos son inicializados en "" (cadena vacía).
Si reduce el tamaño del array, se pierden los últimos elementos borrados del array.

Ejemplo 1

Este ejemplo crea un array de proceso de 100 elementos de tipo Texto:

ARRAY TEXT(atValores;100)

Ejemplo 2

Este ejemplo crea un array local de 100 filas de 50 elementos de tipo Texto:

ARRAY TEXT($atValores;100;50)

Ejemplo 3

Este ejemplo crea un array interproceso de 50 elementos de tipo texto y asigna a cada elemento el valor “Elemento #” seguido por su número de elemento:

 ARRAY TEXT(◊atValues;50)

 For($vlElem;1;50)

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

 End for

Ver también

_o_ARRAY STRING