Scripting/GML-Overview/Arrays/array_copy

Last-modified: 2018-12-21 (金) 19:03:23

array_copy

 

Description
With this function you can copy all or part of one array into another array at any position. You need to supply both the source and the destination arrays (both need to have been created previously), as well as a position within the source array to copy from and a position within the destination array to copy to. Finally you need to specify the length of the array (or the length of the part that you want) to copy. If the data being copied exceeds the length of the destination array, the array will be extended to accept the data.

 

Syntax:

array_copy(dest, dest_index, src, src_index, length);
 

Arguments:

ArgumentDescription
destThe ID of the array to copy to.
dest_indexThe index within the array to copy to.
srcThe ID of the array to copy from.
src_indexThe index with the array to start copying from.
lengthThe length (number of array indices) to copy.
 

Returns:

N/A
 

Example:

if !array_equals(inventory_array, item_array)
   {
   var len = array_length_1d(inventory_array);
   array_copy(item_array, 0, inventory_array, 0, len);
   }
 

The above code will check two arrays to see if they hold equivalent values, and if they do not then the code will copy the entire contents of the array "inventory_array" to the array "item_array".