set: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|game([0-9]) ?= (.+) \|version([0-9]) ?= (.+) " to "|game$1= $2 |version$3= $4 ")
m (Some wiki formatting)
 
(25 intermediate revisions by 3 users not shown)
Line 26: Line 26:
|gr2= HashMap
|gr2= HashMap


|descr= Changes the element at the given zero-based index of the [[Array|array]]. If the index is out of bounds, the array will [[resize]] to incorporate the index as its last value, padding with [[nil]] as necessary. See [[set#Examples| Example 4]].
|descr= Changes the element at the given zero-based index of the [[Array|array]].  


|s1= array '''set''' [index, value]
{{Feature|informative|If the index is out of bounds, the array will [[resize]] to incorporate the index as its last value, padding with [[nil]] as necessary (see {{Link|#Example 4}}). }}
 
|s1= array [[set]] [index, value]


|p1= array: [[Array]]
|p1= array: [[Array]]


|p2= index: [[Number]]
|p2= index: [[Number]] - 0-based array index. {{GVI|arma3|2.12|size= 0.75}} negative index can be used to select from the end of the array, i.e. -1 means last array element.


|p3= value: [[Anything]]
|p3= value: [[Anything]]
Line 38: Line 40:
|r1= [[Nothing]]
|r1= [[Nothing]]


|s2= hashMap '''set''' [key, value] {{Since|arma3|2.02|y}}
|s2= hashMap [[set]] [key, value, insertOnly]


|p21= hashMap : [[HashMap]]
|s2since= arma3 2.02
 
|p21= hashMap: [[HashMap]]


|p22= key: [[HashMapKey]]
|p22= key: [[HashMapKey]]
Line 46: Line 50:
|p23= value: [[Anything]]
|p23= value: [[Anything]]


|r2= [[Boolean]] - [[false|False]] if the key is new to the hashmap, [[true]] if a value got overwritten
|p24= insertOnly: [[Boolean]] - (Optional, default [[false]]) if set to [[true]], set the value only if the key does not exist already
 
|p24since= arma3 2.08
|x1= <code>_arrayOne [[set]] [0, "Hello"];</code>
 
|r2= [[Boolean]] - [[false]] if the key is new to the hashmap, [[true]] if a value got overwritten
 
|x1= <sqf>_arrayOne set [0, "Hello"];</sqf>
 
|x2= Append "Bye" as last element to {{hl|_arrayTwo}}:
<sqf>_arrayTwo set [count _arrayTwo, "Bye"];</sqf>


|x2= Append "Bye" as last element to <tt>_arrayTwo</tt>:<br>
|x3= Replace the last element of {{hl|_arrayThree}} with 23:
<code>_arrayTwo [[set]] [<nowiki/>[[count]] _arrayTwo, "Bye"];</code>
<sqf>_arrayThree set [(count _arrayThree) - 1, 23];</sqf>


|x3= Replace the last element of <tt>_arrayThree</tt> with 23:<br>
|x4= Using [[set]] with an index that is out of bounds:
<code>_arrayThree [[set]] [<nowiki/>([[count]] _arrayThree) - 1, 23];</code>
<sqf>
private _array = ["A"];
_array set [2, "C"]; // _array is now ["A", nil, "C"]
_array set [1, "B"]; // _array is now ["A", "B", "C"]
</sqf>


|x4 = Using [[set]] with an index that is out of bounds:<br>
|x5= <sqf>
<code>_array = ["A"];
private _myHashMap = createHashMap;
_array [[set]] [2, "C"]; {{cc|_array is now ["A", [[nil]], "C"]}}
_myHashMap set ["key", "value1", true]; // "key" value is set to "value1"
_array [[set]] [1, "B"]; {{cc|_array is now ["A", "B", "C"]}}
_myHashMap set ["key", "value2", true]; // "key" value is still "value1" as "key" already exists in the hashmap
</code>
</sqf>


|seealso= [[resize]] [[reverse]] [[select]] [[deleteAt]] [[deleteRange]]  
|seealso= [[resize]] [[reverse]] [[select]] [[deleteAt]] [[deleteRange]]  
}}
}}

Latest revision as of 20:21, 29 April 2023

Logo A0.png1.75ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Changes the element at the given zero-based index of the array.
ⓘ
If the index is out of bounds, the array will resize to incorporate the index as its last value, padding with nil as necessary (see Example 4).
Groups:
ArraysHashMap

Syntax

Syntax:
array set [index, value]
Parameters:
array: Array
index: Number - 0-based array index. Arma 3 logo black.png2.12 negative index can be used to select from the end of the array, i.e. -1 means last array element.
value: Anything
Return Value:
Nothing

Alternative Syntax

Syntax:
hashMap set [key, value, insertOnly]
Parameters:
hashMap: HashMap
key: HashMapKey
value: Anything
since Arma 3 logo black.png2.08
insertOnly: Boolean - (Optional, default false) if set to true, set the value only if the key does not exist already
Return Value:
Boolean - false if the key is new to the hashmap, true if a value got overwritten

Examples

Example 1:
_arrayOne set [0, "Hello"];
Example 2:
Append "Bye" as last element to _arrayTwo:
_arrayTwo set [count _arrayTwo, "Bye"];
Example 3:
Replace the last element of _arrayThree with 23:
_arrayThree set [(count _arrayThree) - 1, 23];
Example 4:
Using set with an index that is out of bounds:
private _array = ["A"]; _array set [2, "C"]; // _array is now ["A", nil, "C"] _array set [1, "B"]; // _array is now ["A", "B", "C"]
Example 5:
private _myHashMap = createHashMap; _myHashMap set ["key", "value1", true]; // "key" value is set to "value1" _myHashMap set ["key", "value2", true]; // "key" value is still "value1" as "key" already exists in the hashmap

Additional Information

See also:
resize reverse select deleteAt deleteRange

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
Retrieved from "https://community.bistudio.com/wiki?title=set&oldid=340315"