Ar Cat

A function added by the Lutana NVSE plugin, now part of the JIP NVSE Plugin.

Description

Concatenates the elements of the second array_var to the first.

If either the first or second array are invalid, will do nothing. Will also do nothing if both arrays have different types.

For Map or StringMap-type arrays, if overrideOldKeys is set to non-zero, then the values for the keys from the baseArray can be overwritten if the toAddArray has matching keys.

Syntax

[help]

ar_Cat baseArray:array_var toAddArray:array_var overrideOldKeys:int{Default:0} 

Or:

pinto_Cat baseArray:array_var toAddArray:array_var overrideOldKeys:int{Default:0}

Example

ar_Cat aBaseArr aToAddArr

With NVSE Compiler Override mode:

set iBaseArrID to aBaseArr
set iToAddArrID to aToAddArr
ar_Cat iBaseArrID iToAddArrID

Notes

• Used to only support "Array"-type arrays, but JIP NVSE v56.34 has fixed this and introduced the overrideOldKeys argument.

See Also

• Array Variables
• Ar_Append will append a single element to an array.
• Ar_Copy