insert: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " |game1= arma3dev |version1= 2.01" to " |game1= arma3 |version1= 2.02")
(added new syntaxes)
Line 36: Line 36:
|r2= [[String]] - The new string
|r2= [[String]] - The new string


|s3= hashMap [[insert]] <nowiki>[[</nowiki>key1, value1], [key2, value2], ...]
|s3= hashMap [[insert]] <nowiki>[[</nowiki>key1, value1], [key2, value2], ...] {{Since|arma3|2.04|y}}


|p41= hashMap: [[HashMap]]
|p41= hashMap: [[HashMap]]
Line 46: Line 46:
|r3= [[Nothing]]
|r3= [[Nothing]]


|x1=
|s4= hashMap '''insert''' [splitArray, [KeysAndValues]] {{Since|arma3|2.04|y}}
 
|p61= hashMap: [[HashMap]]
 
|p62= splitArray: [[Boolean]] - See ''KeysAndValues''
 
|p63= KeysAndValues: [[Array]]
* If ''splitArray'' is [[true]] then in format {{ic|<nowiki>[</nowiki>[key1, key2, ...], [value1, value2, ...]]}}
* If ''splitArray'' is [[false]] then {{ic|<nowiki>[</nowiki>[key1, value1], [key2, value2], ...]}} Same as alt. syntax 2
 
|r4= [[Nothing]]
 
|x1= <code> "Test" [[insert]] [0, "Radio"]; {{cc|Returns "RadioTest"}}</code>
 


|x2=


|seealso=  [[HashMap]]
|seealso=  [[HashMap]]
}}
}}

Revision as of 14:56, 16 April 2021

Hover & click on the images for description

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: Bool - 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], ...] Template:Since
Parameters:
hashMap: HashMap
key: HashMapKey
value: Anything
Return Value:
Nothing

Syntax 4

Syntax:
hashMap insert [splitArray, [KeysAndValues]] Template:Since
Parameters:
hashMap: HashMap
splitArray: Boolean - See KeysAndValues
KeysAndValues: Array
  • If splitArray is true then in format [[key1, key2, ...], [value1, value2, ...]]
  • If splitArray is false then [[key1, value1], [key2, value2], ...] Same as alt. syntax 2
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