Array_Copy -  (內建函數) 陣列函數
語法:
把陣列A的元素複製到陣列B內
Array_Copy(陣列A, 陣列A開始複製的位置, 陣列B, 陣列B開始儲存複製資料的位置, 複製的個數)
如果成功則回傳0,否則回傳小於0的錯誤碼
說明:

請參考以下範例:

Array: arrA[5](0); // 宣告arrA是一個有5個元素的陣列,初始值都是0
Array: arrB[5](0); // 宣告arrB是一個有5個元素的陣列,初始值都是0
Array: arrC[5](0); // 宣告arrC是一個有5個元素的陣列,初始值都是0


arrA[1] = 1;  arrA[2] = 2; arrA[3] = 3; arrA[4] = 4; arrA[5] = 5;


Array_Copy(arrA, 1, arrB, 1, 5); // 執行後 arrB = [1, 2, 3, 4, 5]
Array_Copy(arrA, 1, arrC, 2, 3); // 執行後 arrC = [0, 1, 2, 3, 0]

第一個範例內,指定從arrA的第一個位置開始複製到arrB的第一個位置,總共複製5個元素,所以執行完成後arrB的內容會是[1, 2, 3, 4, 5],剛好跟arrA的數值完全一樣。

第二個範例內,指定從arrA的第一個位置開始複製到arrC的第二個位置,總共複製3個元素,也就是說:

  • arrA[1] 複製到 arrC[2]
  • arrA[2] 複製到 arrC[3]
  • arrA[3] 複製到 arrC[4]

所以執行完成後 arrC的內容會是 [0, 1, 2, 3, 0],注意到arrC的初始值為0,所以沒有被複製到的位置還是保留初始值。