$FUNCNAME$
  ACLONE()
$CATEGORY$
  Array, Object
$SUMMARY$
   Duplicate a nested or multidimensional array
$LANG_RU$
       .
$SYNTAX$
     ACLONE(<aSource>) --> aDuplicate
$LANG_RU$
     ACLONE(<>) -->  
$ARGUMENTS$
     <aSource> is the array to be duplicated.
$LANG_RU$
     <> -  ,  
$RETURNS$
     ACLONE() returns a duplicate of <aSource>.
$LANG_RU$
     ACLONE()    <>.
$DESCRIPTION$

     ACLONE() is an array function that creates a complete duplicate of the
     <aSource> array.  If <aSource> contains subarrays, ACLONE() creates
     matching subarrays and fills them with copies of the values in the
     <aSource> subarrays.  ACLONE() is similar to ACOPY(), but ACOPY() does
     not duplicate nested arrays.


$LANG_RU$

     ACLONE() -    ,   
      <>.   <>  , ACLONE()
            
       <>. ACLONE()  ACOPY(),  ACOPY() 
        .


$EXAMPLES$

       This example creates an array then duplicates it using
	ACLONE().  The first array is then altered, but the duplicate copy is
	unaffected:

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


$LANG_RU$

         ,       
       ACLONE().    ,     
       :

       LOCAL aOne, aTwo
       aOne := { 1, 2, 3 }       // : aOne - {1, 2, 3}
       aTwo := ACLONE(aOne)      // : aTwo - {1, 2, 3}
       aOne[1]:= 99              // : aOne - {99, 2, 3}
				 //  Two - { 1, 2, 3}


$SEEALSO$
  ACOPY(),ADEL(),AINS(),ASIZE(),
$END$
