4D v16.3
COPY ARRAY
- 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 PATHSNew
- DISTINCT ATTRIBUTE VALUESNew
- 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
- _o_ARRAY STRING
4D v16.3
COPY 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.
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.
- 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
PROPERTIES
Product: 4D
Theme: Arrays
Number:
226
HISTORY
Created: < 4D v6
ARTICLE USAGE
4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)
© 1985-2018 4D SAS / 4D, Inc. All rights reserved.