Click above to get retro games delivered to your door ever month!

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