insert: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 19: | Line 19: | ||
|p2= index: [[Number]] - index at which the values will be inserted, -1 for append. | |p2= index: [[Number]] - index at which the values will be inserted, -1 for append. | ||
|p3= [value1, value2, ...]: [[Array]] of [[Anything]] - | |p3= [value1, value2, ...]: [[Array]] of [[Anything]] - values to insert at the specified index | ||
|p4= onlyIfUnique: [[Boolean]] - | |p4= onlyIfUnique: [[Boolean]] - only insert if the value is unique in the array, like [[pushBackUnique]] | ||
|r1= [[Nothing]] | |r1= [[Nothing]] | ||
| Line 31: | Line 31: | ||
|p22= index: [[Number]] - index at which the values will be inserted, -1 for append. | |p22= index: [[Number]] - index at which the values will be inserted, -1 for append. | ||
|p23= substring: [[String]] - | |p23= substring: [[String]] - string to insert | ||
|r2= [[String]] - | |r2= [[String]] - the new string | ||
|s3= hashMap [[insert]] <nowiki>[ | |s3= hashMap [[insert]] [<nowiki/>[key1, value1], [key2, value2], ...] | ||
|s3since= arma3 2.04 | |||
|p41= hashMap: [[HashMap]] | |p41= hashMap: [[HashMap]] | ||
| Line 45: | Line 47: | ||
|r3= [[Nothing]] | |r3= [[Nothing]] | ||
|s4= hashMap [[insert]] [splitArray, [ | |s4= hashMap [[insert]] [splitArray, [keysAndValues]] | ||
|s4since= arma3 2.04 | |||
|p61= hashMap: [[HashMap]] | |p61= hashMap: [[HashMap]] | ||
|p62= splitArray: [[Boolean]] - | |p62= splitArray: [[Boolean]] - determines ''keysAndValues'' format (see ''keysAndValues''<nowiki/>'s description) | ||
|p63= | |p63= keysAndValues: [[Array]] - in format depending on ''splitArray''<nowiki/>'s value: | ||
* [[true]] - {{ic|[<nowiki/>[key1, key2, ...], [value1, value2, ...]]}} | |||
* | * [[false]] - {{ic|[<nowiki/>[key1, value1], [key2, value2], ...]}} (same as {{HashLink|#Syntax 3}}) | ||
|r4= [[Nothing]] | |r4= [[Nothing]] | ||
|x1= < | |x1= <sqf>"Test" insert [0, "Radio"]; // returns "RadioTest"</sqf> | ||
|seealso= [[HashMap]] | |seealso= [[HashMap]] | ||
}} | }} | ||
Revision as of 14:56, 5 May 2022
Description
- Description:
- Inserts multiple values into Array/String/HashMap.
The String variant also supports forceUnicode. - Groups:
- HashMapArraysStrings
Syntax 1
- Syntax:
- array insert [index, [value1, value2, ...], onlyIfUnique]
- Parameters:
- array : Array
- index: Number - index at which the values will be inserted, -1 for append.
- [value1, value2, ...]: Array of Anything - values to insert at the specified index
- onlyIfUnique: Boolean - only insert if the value is unique in the array, like pushBackUnique
- Return Value:
- Nothing
Syntax 2
- Syntax:
- string insert [index, substring]
- Parameters:
- string : String
- index: Number - index at which the values will be inserted, -1 for append.
- substring: String - string to insert
- Return Value:
- String - the new string
Syntax 3
- Syntax:
- hashMap insert [[key1, value1], [key2, value2], ...]
- Parameters:
- hashMap: HashMap
- key: HashMapKey
- value: Anything
- Return Value:
- Nothing
Syntax 4
- Syntax:
- hashMap insert [splitArray, [keysAndValues]]
- Parameters:
- hashMap: HashMap
- splitArray: Boolean - determines keysAndValues format (see keysAndValues's description)
- keysAndValues: Array - in format depending on splitArray's value:
- Return Value:
- Nothing
Examples
- Example 1:
- "Test" insert [0, "Radio"]; // returns "RadioTest"
Additional Information
- See also:
- HashMap
Notes
-
Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note