Places an element at a specific index of an array:
_array = [1,2,4]; _index = 0; _value = 0; _array insert [_index, _value]; //[0,1,2,4]; _index = 3; _value = 3; _array insert [_index, _value]; //[0,1,2,3,4] _array insert [6, "outOfBounds"]; //[0,1,2,3,4,nil,"outOfBounds"]
or maybe it could work like append:
_array = []; _index = 0; _values = [1,2,3]; _array insert [_index, _values];//[1,2,3];
alternative name: insertAt
maybe the command could support strings too?
-1 index for "at end"
you could just use append for that, but I can either just support it, or add checking and error for negative index.
_array = []; _array insert [-1, [1,2,4]]; //[0,1,2,4]; _index = 0; _value = 0; _array insert [_index, [_value]]; //[0,1,2,4]; _index = 3; _value = 3; _array insert [_index, [_value]]; //[0,1,2,3,4] _array insert [6, ["outOfBounds"]]; _array
[0,1,2,3,4,<null>,"outOfBounds"]
"test" insert [-1, "ab"] // "testab" "test" insert [1, "ab"] // "tabest" "test" insert [0, "ab"] // "abtest"
The array version of this command seems to be buggy
Test code:
testArr = [0,1,2]; testArr insert[0,[7]]; // Run twice from console to crash arma