Description
Inserts multiple values into Array/String/HashMap.
The String variant also supports forceUnicode. In the event of a HashMap, values, if they already exist, are replaced.
Syntax
Syntax 1
array insert [index, valuesToInsert, onlyIfUnique]
Parameters:
array: Array of Anythingindex: Number - index at which the values will be inserted, -1 for append, Arma 3 v2.14 -2 for inserting at the second-to-last position, -3 before that, etc.valuesToInsert: Array of Anything - values to insert at the specified indexonlyIfUnique: Boolean - (Optional, default false) only insert if the value is unique in the array, like pushBackUnique
Returns: Nothing
Syntax 2
string insert [index, substring]
Parameters:
string: Stringindex: Number - index at which the values will be inserted, -1 for appendsubstring: String - string to insert
Returns: String - the new string
Syntax 3
since arma3 2.04
hashMap insert [[key1, value1], [key2, value2], ...]
Parameters:
hashMap: HashMapkeyN: HashMapKeyvalueN: Anything
Returns: Nothing
Syntax 4
since arma3 2.04
hashMap insert [splitArray, [keysAndValues]]
Parameters:
hashMap: HashMapsplitArray: Boolean - determines keysAndValues format (see keysAndValues's description)keysAndValues: Array - in format depending on splitArray's value:- true -
[[key1, key2, ...], [value1, value2, ...]] - false -
[[key1, value1], [key2, value2], ...](same as #Syntax 3, see #Example 3 for the correct format)
- true -
Returns: Nothing
Examples
Example 1
"Test" insert [0, "Radio"]; // returns "RadioTest"
"Test" insert [2, "Radio"]; // returns "TeRadiost"
"Test" insert [-1, "Radio"]; // returns "TestRadio"
Example 2
private _array = ["a", "b", "c"];
_array insert [0, ["w"]]; // _array is now ["w", "a", "b", "c"]
private _array = ["a", "b", "c"];
_array insert [-1, ["w"]]; // _array is now ["a", "b", "c", "w"]
private _array = ["a", "b", "c"];
_array insert [-2, ["w"]]; // _array is now ["a", "b", "w", "c"] // Arma 3 v2.14
Example 3
// Notice how the size of the right array changes depending on the format of keysAndValues format
private _map = createHashMap;
_map insert [false, ["one", 1]];
private _map = createHashMap;
_map insert [true, ["one"], [1]];