LIST TO ARRAY
LIST TO ARRAY ( lista ; array {; refElementos} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| lista | Text, Integer | → | 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 |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
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"
...