Collection

Coleções são listas ordenadas de valores de tipos diferentes ou não (texto, número, objeto, booleano, coleção ou null).

Para gerenciar variáveis do tipo Coleção, você deve usar notação objeto (veja Noções básicas de Sintaxe).

Para acessar a um elemento de coleção, é necessário passar o número do elemento dentro de parênteses rectos:

collectionRef[expression]

Você pode passar qualquer expressão 4D válida que retorne um inteiro positivo em expressão. Exemplos:

 myCollection[5]  //aceso ao 6º elemento da coleção
 myCollection[$var]

Atenção: os elementos da coleção estão numerados desde 0.

Você pode atribuir um valor a um elemento de coleção ou obter um valor de elemento de coleção usando notação objeto:

 myCol[10]:="My new element"
 $myVar:=myCol[0]

Se atribuir um índice de elemento que ultrapasse o último elemento existente da coleção, a coleção se redimensiona automaticamente e a todos os novos elementos intermediários se lhes atribui um valor nulo:

 C_COLLECTION(myCol)
 myCol:=New collection("A";"B")
 myCol[5]:="Z"
  //myCol[2]=null
  //myCol[3]=null
  //myCol[4]=null

Inicialização

Coleções devem ter sido inicializadas, por exemplo, usando o comando New collection, caso contrário, tentar ler ou modificar seus elementos gerará um erro de sintaxe.

Exemplo:

 C_COLLECTION($colVar) //criação de uma variável 4D do tipo coleção
 $colVar:=New collection //inicialização da coleção e atribuição à variável 4D

Coleção regular ou partilhada

Pode criar dois tipos de coleções:

• coleções regulares (não compartilhadas) usando o comando New collection. Essas coleções podem ser editadas sem qualquer controle de acesso específico mas não podem ser compartilhadas entre processos.
• coleções compartilhadas, usando o comando New shared collection. Essas coleções podem ser partilhadas entre processos, incluindo threads preemptivos. Acesso a estas coleções é controlado por estruturas Use...End use. Para saber mais, consulte a seção Objetos e coleções compartidos.

Métodos de coleção

As referências a coleções 4D se beneficiam de métodos especiais (às vezes chamados funções membro). Graças a notação objeto, esses métodos podem ser aplicados às referências de coleções usando a seguinte sintaxe:

{$result:=}myCollection.memberFunction( {params} )

Observe que, mesmo que ele não tenha parâmetros, uma função membro deve ser chamada com parênteses (), caso contrário, um erro de sintaxe é gerado.

Por exemplo:

$newCol:=$col.copy() //cópia de $col a $newCol
$col.push(10;100) //adiciona 10 e 100 para a coleção

Alguns métodos retornam a coleção original após modificação, para poder rodar as chamadas em sequência:

 $col:=New collection(5;20)
 $col2:=$col.push(10;100).sort() //$col2=[5,10,20,100]

parâmetro caminoPropriedade

Vários métodos aceitam um propertyPath como parâmetro. Este parâmetro significa:

• um nome de objeto propriedade por exemplo "Sobrenome"
• ou uma rota de propriedades de objeto, ou seja, uma sequência hierárquica de subpropriedades vinculadas com caracteres de ponto, por exemplo "empregado.filhos.nome".

Advertência: ao usar métodos e parâmetros propertyPath, não se pode usar ".", "[ ]", ou espaços nos nomes das propriedades, dado que isso impedirá que 4D analise corretamente o caminho:

 $vmin:=$col.min("My.special.property") //indefinido
 $vmin:=$col.min(["My.special.property"]) //erro