4D v16.3

LIST TO ARRAY

Página Inicial

 
4D v16.3
LIST TO ARRAY

LIST TO ARRAY 


 

LIST TO ARRAY ( lista ; array {; itemRefs} ) 
Parâmetro Tipo   Descrição
lista  String, ListRef in Lista da qual copiar os itens de primeiro nível
array  Array in Array para o qual copiar os itens da lista
itemRefs  Array in Números de referência da lista de itens

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.

O exemplo a seguir copia os elementos de uma lista chamada Regiões no array chamado atRegioes:

 LIST TO ARRAY("Regions";atRegions)

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"
 ...



Ver também 

ARRAY TO LIST
Load list
SAVE LIST

 
PROPRIEDADES 

Produto: 4D
Tema: Arrays
Número 288

 
HISTÓRIA 

Criado por: < 4D v6
Modificado: 4D v14

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)