4D Doc Center : LIST TO ARRAY

4D v12.4

LIST TO ARRAY


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

Parâmetro	Tipo	Descrição
lista	cadeia	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

Nota de compatibilidade

Devido à nova implementação de listas hierárquicas, a compatibilidade deste comando não pode ser mantida totalmente. Da mesma forma, a partir da versão 6, recomendamos que você comece a utilizar o comando Load list para trabalhar com as listas hierárquicas definidas no editor de listas do ambiente Desenho.

Descrição

O comando LIST TO ARRAY cria ou substitui o array array com os elementos de primeiro nível da lista lista.

LIST TO ARRAY cria ou substitui um array com um novo array tipo texto.

O parâmetro opcional itemRefs (um array de tipo numérico) retorna os números de referência dos elementos da lista.

Nota de compatibilidade: na versão anterior de 4D, este array se preenchia com os nomes das listas associadas. Se um elemento da lista tinha uma lista associada, o nome da lista associada era colocado no elemento do array com o mesmo número que o elemento da lista. Se não existia uma lista associada, então o elemento era a cadeia vazia. O segundo array era do mesmo tamanho de array. É possível utilizar os nomes neste array para acessar às listas associadas.

É 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 oferece os meios para trabalhar com os elementos das sub-listas, se essas existirem. Para trabalhar com listas hierárquicas, utilize os novos comandos de listas hierárquicas introduzidos na versão 6.

Exemplo

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

LIST TO ARRAY("Regioes";atRegioes)