LIST TO ARRAY

4D v16.3

LIST TO ARRAY


LIST TO ARRAY ( lista ; array {; refElementos} )

Parámetro	Tipo	Descripción
lista	Cadena, ListRef	Lista de la cual copiar los elementos de primer nivel
array	Array	Array al cual copiar los elementos de la lista
refElementos	Array	Números de referencia de los elementos de la lista

Descripción

El comando LIST TO ARRAY crea o reemplaza el array array con los elementos del primer nivel de la lista o de la lista de selección designada por lista.

En el parámetro lista puede pasar el nombre de una lista de selección (cadena), o una referencia de lista jerárquica (RefList).

Si no define previamente el array como de tipo Alfa o Texto, LIST TO ARRAY crea un nuevo array de tipo Texto por defecto.

Nota: en modo compilado, el array debe haber sido definido previamente y no puede ser digitado nuevamente.

El parámetro opcional refElements (un array de tipo numérico) devuelve los números de referencia de los elementos de la lista.

Puede utilizar LIST TO ARRAY para construir un array basado en los elementos de primer nivel de una lista. Sin embargo, este comando no le permite trabajar con los elementos de las sublistas. Para trabajar con listas jerárquicas, utilice los comandos de listas jerárquicas, en particular Load list.

Ejemplo 1

El siguiente ejemplo copia los elementos de una lista llamada Regiones en el array llamado atRegions:

LIST TO ARRAY("Regions";atRegions)

Ejemplo 2

Dada una lista jerárquica creada como se ve a continuación:

 myList2:=New list

 APPEND TO LIST(myList2;"Scotland";1)

 APPEND TO LIST(myList2;"England";2)

 APPEND TO LIST(myList2;"Wales";3)

 myList1:=New list

 APPEND TO LIST(myList1;"France";1)

 APPEND TO LIST(myList1;"Germany";2)

 APPEND TO LIST(myList1;"Spain";3)

 APPEND TO LIST(myList1;"Great Britain";4;myList2;True)

 APPEND TO LIST(myList1;"Portugal";5)

 APPEND TO LIST(myList1;"Belgium";6)

 APPEND TO LIST(myList1;"Italy";7)

 APPEND TO LIST(myList1;"Netherlands";8)

 APPEND TO LIST(myList1;"Ireland";9)

Esta lista puede estar representada como:

Si ejecuta la siguiente instrucción:

LIST TO ARRAY(myList1;$MyArray)

...obtiene

 $MyArray{1}="France"

 $MyArray{2}="Germany"

 $MyArray{3}="Spain"

 $MyArray{4}="Great Britain"

 $MyArray{5}="Portugal"

 ...

Ver también

ARRAY TO LIST
Load list
SAVE LIST