Difference between revisions of "CopyArray"

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search
imported>Haama
(Added DupArray)
imported>Speedo
(updated syntax)
Line 4: Line 4:


'''Syntax:'''
'''Syntax:'''
  (ArrayID:long) CopyArray ArrayID:long ''Size:long''
  (ArrayID:long) CopyArray ArrayID:long ''Size:long RefuseZero:short''
  (ArrayID:long) DupArray ArrayID:long ''Size:long''
  (ArrayID:long) DupArray ArrayID:long ''Size:long RefuseZero:short''


Creates a copy of an array and returns the newly created ArrayID.
Creates a copy of an array and returns the newly created ArrayID.
Line 12: Line 12:
*If you want to modify an array from another mod, you will need to set the Global flag to 1. If Global is 0 or unset the function will fail. If the array is protected the function will fail.
*If you want to modify an array from another mod, you will need to set the Global flag to 1. If Global is 0 or unset the function will fail. If the array is protected the function will fail.
*If the array does not exist, it returns -1.
*If the array does not exist, it returns -1.
*If ''RefuseZero'' is 1, then the new Array's ID will never be zero.


==Notes==
==Notes==

Revision as of 01:59, 10 March 2008


A command for Pluggy

Syntax:

(ArrayID:long) CopyArray ArrayID:long Size:long RefuseZero:short
(ArrayID:long) DupArray ArrayID:long Size:long RefuseZero:short

Creates a copy of an array and returns the newly created ArrayID.

  • If Size is not specified, the new array size is the same as the original.
  • If Size is specified, the new array will be of the specified size (truncated or expanded).
  • If you want to modify an array from another mod, you will need to set the Global flag to 1. If Global is 0 or unset the function will fail. If the array is protected the function will fail.
  • If the array does not exist, it returns -1.
  • If RefuseZero is 1, then the new Array's ID will never be zero.

Notes

  • The new array has its EspID set to the calling esp