versión 3
Nota de compatibilidad
Debido a la nueva implementación de listas jerárquicas, la compatibilidad de este comando no se puede mantener totalmente. Igualmente, a partir de la versión 6, recomendamos que utilice el comando SAVE LIST para trabajar con listas jerárquicas definidas en el editor de listas del entorno Diseño.
ARRAY TO LIST (Array; lista{; itemRefs})
Parámetro | Tipo | Descripción | |
Array | Array | Array del cual copiar los elementos del array | |
lista | Alfa | Lista en la cual copiar los elementos del array | |
itemRefs | Array | Array numérico de números de referencia de los elementos |
Descripción
El comando ARRAY TO LIST crea o reemplaza la lista lista (definida en el editor de listas del entorno Diseño) utilizando los elementos del array array.
Este comando le permite definir sólo los elementos del primer nivel de la lista.
El parámetro opcional itemRefs, si se especifica, debe ser un array numérico sincronizado con el array array. Cada elemento, indica el número de referencia del elemento de la lista correspondiente en array. Si omite este parámetro, 4D define automáticamente los números de referencia de los elementos de la lista 1, 2... N.
Nota de compatibilidad: en la versión anterior de 4D, este parámetro era utilizado para conectar otras listas a cada elemento del array. Si un elemento del array links corresponde al nombre de una lista existente, entonces esa lista era asociada al elemento correspondiente.
Puede continuar utilizando ARRAY TO LIST para construir una lista basada en los elementos de un array. Sin embargo, este comando no le ofrece los medios para trabajar con sublistas. Para trabajar con listas jerárquicas, utilice los nuevos comandos de listas jerárquicas introducidos en la versión 6.
Ejemplo
El siguiente ejemplo copia el array atRegiones en la lista "Regiones:"
ARRAY TO LIST (atRegiones;"Regiones")
Ver también
LIST TO ARRAY, Load list, ON ERR CALL, SAVE LIST.
Manejo de errores
El comando ARRAY TO LIST genera el error -9957 cuando se aplica a una lista que está siendo editada en el editor de listas del entorno Diseño. Puede interceptar este error utilizando un método de proyecto ON ERR CALL.