Difference between revisions of "ACOPY()"

From Recital Documentation Wiki
Jump to: navigation, search
 
Line 37: Line 37:
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
[[Category:Array Processing]]
 +
[[Category:Array Processing Functions]]

Revision as of 15:35, 1 June 2009

Class

Array Processing


Purpose

Function to copy elements from one array to another


Syntax

ACOPY(<array1>,<array2> [,<expN1> [,<expN2> [,<expN3>]]])


See Also

AADD(), AAVERAGE(), ABROWSE(), ACHOICE(), ACOL(), ADEL(), ADESC(), ADIR(), AELEMENT(), AFIELDS(), AFILL(), AINS(), ALEN(), AMAX(), AMIN(), APPEND FROM ARRAY, AROW(), ASCAN(), ASIZE(), ASORT(), ASTORE(), ASTRING(), ASUBSCRIPT(), ASUM(), COPY TO ARRAY, DECLARE, DIMENSION, GATHER, LOCAL, PRIVATE, PUBLIC, RELEASE, RESTORE, SAVE, SCATTER


Description

The ACOPY() function allows the transfer of elements between arrays, enabling arrays to be subdivided or combined. The destination array must have sufficient elements to receive all those transferred. All elements of the source array <array1> will be copied to the target array <array2> unless <expN1> is entered to specify the element from which to start copying. The specification of <expN2> sets the number of elements to be copied sequentially. The starting element in the target array can be set with <expN3>.


Example

declare overview[4000]
declare north[2000]
// Copy first 2000 elements from source array
// starting from position 1 in the target array
acopy(north,overview,1,2000,1)
declare south[1500]
// Copy first 1500 elements from source array
// starting from position 2001 in the target array
acopy(south,overview,1,1500,2001)


Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer