getOrDefault: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \|([ps][0-9]+) *= " to " |$1= ")
(setDefault parameter was missing)
Line 8: Line 8:
|descr= Retrieves a value out of a [[HashMap]] after looking it up by its key. When the HashMap doesn't contain the key, the default value is returned
|descr= Retrieves a value out of a [[HashMap]] after looking it up by its key. When the HashMap doesn't contain the key, the default value is returned


|s1= hashMap [[getOrDefault]] [key, defaultValue]
|s1= hashMap [[getOrDefault]] [key, defaultValue, setDefault]


|p1= hashMap : [[HashMap]]
|p1= hashMap : [[HashMap]]
Line 24: Line 24:


|x2= <code>[[private]] _myValue = _hashMap [[getOrDefault]] ["a", "Not Found!", [[true]]]; {{cc|Will add default value to the hash map if it does not exist}}</code>
|x2= <code>[[private]] _myValue = _hashMap [[getOrDefault]] ["a", "Not Found!", [[true]]]; {{cc|Will add default value to the hash map if it does not exist}}</code>
|x3= <code>[[private]] _array = _hashmap [[getOrDefault]] [_key, [], [[true]]]; {{cc|a new array will be created if it doesn't exist}}
_array [[pushBack]] _item; {{cc|_item will be added to the array (the one in the hashmap is updated by reference)}}</code>


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

Revision as of 22:12, 13 February 2022

Hover & click on the images for description

Description

Description:
Retrieves a value out of a HashMap after looking it up by its key. When the HashMap doesn't contain the key, the default value is returned
Groups:
HashMap

Syntax

Syntax:
hashMap getOrDefault [key, defaultValue, setDefault]
Parameters:
hashMap : HashMap
key: HashMapKey - Case sensitive key
defaultValue: Anything - (Optional, default nil)
since Arma 3 logo black.png2.04
setDefault: Boolean - (Optional, default false) - If set to true and value does not exist in provided hash map, defaultValue will be added to the hash map
Return Value:
Anything

Examples

Example 1:
private _myValue = _myHashMap getOrDefault ["a", "Not Found!"];
Example 2:
private _myValue = _hashMap getOrDefault ["a", "Not Found!", true]; // Will add default value to the hash map if it does not exist
Example 3:
private _array = _hashmap getOrDefault [_key, [], true]; // a new array will be created if it doesn't exist _array pushBack _item; // _item will be added to the array (the one in the hashmap is updated by reference)

Additional Information

See also:
HashMap get

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