Saltar para o conteúdo principal
Versão: Próximo

COPY ARRAY

COPY ARRAY ( fonte ; destino )

ParâmetroTipoDescrição
fonteArrayArray do qual se copia
destinoArrayArray para o qual se copia

Descrição

O comando COPY ARRAY cria ou reescreve o array de destino com os mesmos conteúdo, tamanho e fonte do array fonte.

Nota: no caso de arrays numéricos de tipos diferentes, o tipo de array destino é mantido.

Os arrays fonte e destino podem ser arrays locais, de processo ou interprocesso. Ao se copiar arrays, o tamanho do array não interessa.

Notas:

  • em modo compilado, o array destino deve ser do mesmo tipo que o array fonte. Assim é recomendado sempre usar arrays do mesmo tipo para ter comportamento similar em modos interpretado e compilado.
  • Quando copiar arrays de objeto, apenas referênc ias a objetos que eles contem são duplicadas, e não os objetos em si. Significa que qualquer modificação feita em um objeto em um array serão aplicadas a instancias existentes do objeto em arrays copiados. Se precisar duplicar objetos, deve usar o comando OB Copy.

Exemplo

O exemplo seguinte preenche o array chamado C. Ele então cria um novo array, chamado D, do mesmo tamanho e conteúdo que o C:

 ALL RECORDS([Pessoas]) // Selecionar todos os registros em Pessoas
 SELECTION TO ARRAY([Pessoas]Empresa;C) // Mover os dados do campo empresa ao array C
 COPY ARRAY(C;D) // Copiar o array C ao array D