Ar Cat

A function added by the Lutana NVSE plugin.

Description

Concatentates arrays, returning the combined result.

JIP NVSE Plugin v40 merged Lutana NVSE plugin v19. As of JIPv40, This function's syntax was changed from Lutana v19, requiring that you pass the arrays via their IDs (set to integers) if you use the script compiler override (CO).

Syntax

[help]

(array) ar_Cat baseArrayID:arrayVar toAddArrayID:arrayVar 

Or:

(array) pinto_Cat baseArrayID:arrayVar toAddArrayID:arrayVar

Example (regular)

array_var arrA ; array to add to
array_var arrB ; array to add

ar_cat arrA, arrB

Example (with CO)

array_var arrA
array_var arrB
int iArrAID
int iArrBID
...
set iArrAID to arrA
set iArrBID to arrB
ar_Cat iArrAID iArrBID

Old Syntax (Lutana standalone)

(concatenatedArray) ar_Cat arrayToAddTo:array arrayToAdd:array

Notes

Ar_Cat changes the "to add to" array in place, and will not return anything if you 'let' an arrayVar to it (ie let SomeArray := ar_cat arrayA, arrayB), producing NVSE errors. An alternative way that only requires NVSE is using ar_insertrange with the index being the size of the base array.

See Also

• Array_Variables
• Ar_InsertRange