LIST TO ARRAY
LIST TO ARRAY ( lista ; array {; itemRefs} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| lista | Text, Integer | → | Lista da qual copiar os itens de primeiro nível |
| array | Array | ← | Array para o qual copiar os itens da lista |
| itemRefs | Array | ← | Números de referência da lista de itens |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando LIST TO ARRAY cria ou substitui o array array com os elementos de primeiro nível da lista ou da lista de seleção designada por lista.
No parâmetro lista pode passar o nome de uma lista de seleção (cadeia), ou uma referência de lista hierárquica (RefList).
Se não definir previamente o array como de tipo Alfa ou Texto, LIST TO ARRAY cria um novo array de tipo Texto por padrão.
Nota: em modo compilado, o array deve ter sido definido previamente e não pode ser digitado novamente.
O parâmetro opcional itemRefs (um array de tipo numérico) retorna os números de referência dos elementos da lista.
É possível continuar utilizando LIST TO ARRAY para construir um array baseado nos elementos de primeiro nível de uma lista. Entretanto, este comando não lhe permite trabalhar com os elementos das sub-listas. Para trabalhar com listas hierárquicas, utilize os comandos de listas hierárquicas, em particular Load list.
Exemplo 1
O exemplo a seguir copia os elementos de uma lista chamada Regiões no array chamado atRegioes:
LIST TO ARRAY("Regions";atRegions)
Exemplo 2
Dada uma lista hierárquica criada como é visto a continuação:
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 pode estar representada como:
Se executa a seguinte instrução:
LIST TO ARRAY(myList1;$MyArray)
...obtém
$MyArray{1}="France"
$MyArray{2}="Germany"
$MyArray{3}="Spain"
$MyArray{4}="Great Britain"
$MyArray{5}="Portugal"
...