aArrayArrayObrigatório
Array que será duplicado. Pode conter uma ou mais dimensões.
FUNçãOPublicado
AClone
AClone( <aArray> )Duplica um array, inclusive seus subarrays em estruturas multidimensionais.
Visão geral
AClone() cria uma cópia independente do array informado. Diferentemente de uma atribuição simples, que apenas aponta duas variáveis para a mesma estrutura, AClone() replica os elementos e também os subarrays existentes. Por isso é indicada quando a rotina precisa alterar a cópia sem interferir no array original.
Sintaxe
AClone( <aArray> )Parâmetros
Clonando um array simples
User Function AClone1()
Local aMatriz1 := { 10, 20, 30 }
Local aMatriz2 := AClone(aMatriz1)
Local nCont := 0
For nCont := 1 To Len(aMatriz2)
MsgInfo( CValToChar(aMatriz2[nCont]) )
Next nCont
ReturnResultado esperado
O array clonado contém os mesmos valores do array original: 10, 20 e 30.
Cópia independente de array multidimensional
User Function AClone2()
Local aOriginal := { {"Produto", 10}, {"Serviço", 20} }
Local aCopia := AClone(aOriginal)
aCopia[1][2] := 99
MsgInfo("Original: " + CValToChar(aOriginal[1][2]))
MsgInfo("Cópia: " + CValToChar(aCopia[1][2]))
ReturnResultado esperado
Alterar a cópia não muda o valor do array original, inclusive quando há subarrays.
- Use AClone() quando a cópia será modificada e o array original precisa permanecer intacto.
- AClone() é especialmente útil em arrays multidimensionais, pois também replica subarrays.
- A referência TDN compara AClone() com ACopy(): ACopy() é voltada a arrays unidimensionais, enquanto AClone() atende estruturas multidimensionais.
- Atribuir aCopia := aOriginal não clona o array; as duas variáveis passam a apontar para a mesma estrutura.
- Clonar arrays muito grandes pode aumentar consumo de memória.
- Ao clonar dados sensíveis ou temporários, cuide do ciclo de vida da cópia para não manter informação desnecessária em memória.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.