# ACLONE()

Duplicate a multidimensional array

Syntax

  ACLONE(<aSource>) --> aDuplicate

Arguments

  <aSource> Name of the array to be cloned.

Returns

  <aDuplicate> A new array pointer reference complete with nested array values.

Description

  This function makes a complete copy of the array expressed as <aSource> and return a cloned set of array values.This provides a complete set of arrays values for all dimensions within the original array <aSource>

Examples

          LOCAL aOne, aTwo
          aOne := {"Harbour"," is ","POWER"}
          aTwo := ACLONE(aOne)       // Result: aTwo is {1, 2, 3}
          aOne[1] := "The Harbour Compiler"              // Result: aOne is {99, 2, 3}
                                     // aTwo is still {1, 2, 3}

Status

  Ready

Compliance

  Clipper will return NIL if the parameter is not an array.

Files

  Library is vm

See Also

- ACOPY()
- ADEL()
- AINS()
- ASIZE()