This is the legacy 4D documentation web site. Documentations are progressively being moved to developer.4d.com
- 4D Language Reference
-
- Arrays
-
-
Arrays
-
Creating Arrays
-
Arrays and Form Objects
-
Arrays and the 4D Language
-
Arrays and Pointers
-
Using the element zero of an array
-
Two-dimensional Arrays
-
Arrays and Memory
-
APPEND TO ARRAY
-
ARRAY BLOB
-
ARRAY BOOLEAN
-
ARRAY DATE
-
ARRAY INTEGER
-
ARRAY LONGINT
-
ARRAY OBJECT
-
ARRAY PICTURE
-
ARRAY POINTER
-
ARRAY REAL
-
ARRAY TEXT
-
ARRAY TIME
-
ARRAY TO LIST
-
ARRAY TO SELECTION
-
BOOLEAN ARRAY FROM SET
-
COPY ARRAY
-
Count in array
-
DELETE FROM ARRAY
-
DISTINCT ATTRIBUTE PATHS
-
DISTINCT ATTRIBUTE VALUES
-
DISTINCT VALUES
-
Find in array
-
Find in sorted array
-
INSERT IN ARRAY
-
LIST TO ARRAY
-
LONGINT ARRAY FROM SELECTION
-
MULTI SORT ARRAY
-
SELECTION RANGE TO ARRAY
-
SELECTION TO ARRAY
-
Size of array
-
SORT ARRAY
-
TEXT TO ARRAY
-
COPY ARRAY
| COPY ARRAY ( source ; destination ) | ||||||||
| Parameter | Type | Description | ||||||
| source | Array |
|
Array from which to copy | |||||
| destination | Array |
|
Array to which to copy | |||||
The COPY ARRAY command creates or overwrites the destination array destination with the exact contents, size, and type of the source array source.
Note: In case of numeric arrays of different types, the type of the destination array is kept.
The source and destination arrays can be local, process, or interprocess arrays. When copying arrays, the scope of the array does not matter.
Notes:
- In compiled mode, the destination array must be of the same type as the source array. Thus, it is recommended to always use arrays of the same type to have similar behavior in interpreted and compiled modes.
- When you copy object arrays, only references to the objects that they contain are duplicated, and not objects themselves. It means that any modification done on an object in an array will be applied to all existing instances of the object in copied arrays. If you need to duplicate objects, you must use the OB Copy command.
The following example fills the array named C. It then creates a new array, named D, of the same size as C and with the same contents:
ALL RECORDS([People]) ` Select all records in People
SELECTION TO ARRAY([People]Company;C) ` Move company field data into array C
COPY ARRAY(C;D) ` Copy the array C to the array D
Product: 4D
Theme: Arrays
Number:
226
Created: < 4D v6
4D Language Reference ( 4D v20 R7)
