uniqueUnitItems: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Fix description)
m (Some wiki formatting)
 
(2 intermediate revisions by the same user not shown)
Line 7: Line 7:


|eff=
|eff=
|branch= dev


|descr= Returns hashmap of all items in units inventory as [classname, count] pairs.
|descr= Returns hashmap of all items in units inventory as [classname, count] pairs.
Line 21: Line 19:
|gr1= Unit Inventory
|gr1= Unit Inventory


|s1= [[uniqueUnitItems]] [unit, weaponsItems, uniformItems, vestItems, backpackItems, assignedItems]
|s1= [[uniqueUnitItems]] unit


|p1= unit: [[Object]]
|p1= unit: [[Object]]


|p2= weaponsItems: [[Number]] - (Optional, default 2) weapons (including binoculars) and their accessories (flashlight etc), loaded magazines
|r1= [[HashMap]] in format itemClassname ([[String]]) → amount ([[Number]])
 
|s2= [[uniqueUnitItems]] [unit, weaponsItems, uniformItems, vestItems, backpackItems, assignedItems]
 
|p21= unit: [[Object]]


|p3= uniformItems: [[Number]] - (Optional, default 2)
|p22= weaponsItems: [[Number]] - (Optional, default 2) weapons (including binoculars) and their accessories (flashlight etc), loaded magazines


|p4= vestItems: [[Number]] - (Optional, default 2)
|p23= uniformItems: [[Number]] - (Optional, default 2)


|p5= backpackItems: [[Number]] - (Optional, default 2)
|p24= vestItems: [[Number]] - (Optional, default 2)


|p6= assignedItems: [[Boolean]] - (Optional, default [[true]]) returns [[assignedItems]] as well as [[headgear]] and [[hmd|goggles]]
|p25= backpackItems: [[Number]] - (Optional, default 2)


|r1= [[HashMap]] in format itemClassname ([[String]]) → amount ([[Number]])
|p26= assignedItems: [[Boolean]] - (Optional, default [[true]]) returns [[assignedItems]] as well as [[headgear]] and [[hmd|goggles]]
 
|r2= [[HashMap]] in format itemClassname ([[String]]) → amount ([[Number]])


|x1= <code>[[private]] _unitUniqueItems = [[uniqueUnitItems]] [<nowiki/>[[player]], 0, 2, 2, 2, [[true]]];
|x1= <sqf>
[[if]] (_unitUniqueItems [[getOrDefault]] ["FirstAidKit", 0] > 5) [[then]] { [[hint]] "I'm rich of FAK to give!"; };</code>
private _unitUniqueItems = uniqueUnitItems [player, 0, 2, 2, 2, true];
if (_unitUniqueItems getOrDefault ["FirstAidKit", 0] > 5) then { hint "I'm rich of FAK to give!"; };
</sqf>


|x2= <code>[[private]] _unitUniqueItems = [[uniqueUnitItems]] [<nowiki/>[[cursorObject]]];</code>
|x2= <sqf>private _unitUniqueItems = uniqueUnitItems [cursorObject];</sqf>


|seealso= [[getUnitLoadout]]
|seealso= [[getUnitLoadout]]
}}
}}

Latest revision as of 19:43, 5 May 2022

Hover & click on the images for description

Description

Description:
Returns hashmap of all items in units inventory as [classname, count] pairs.
  • weaponItems, uniformItems, vestItems, backpackItems arguments use the following Number values:
    • 0: do not return value
    • 1: returns container only (weapon or container)
    • 2: returns container and its content
  • weapons/containers that are stored inside containers (e.g weapon in backpack) always return all contents if contents for the parent container are enabled.
Groups:
Unit Inventory

Syntax

Syntax:
uniqueUnitItems unit
Parameters:
unit: Object
Return Value:
HashMap in format itemClassname (String) → amount (Number)

Alternative Syntax

Syntax:
uniqueUnitItems [unit, weaponsItems, uniformItems, vestItems, backpackItems, assignedItems]
Parameters:
unit: Object
weaponsItems: Number - (Optional, default 2) weapons (including binoculars) and their accessories (flashlight etc), loaded magazines
uniformItems: Number - (Optional, default 2)
vestItems: Number - (Optional, default 2)
backpackItems: Number - (Optional, default 2)
assignedItems: Boolean - (Optional, default true) returns assignedItems as well as headgear and goggles
Return Value:
HashMap in format itemClassname (String) → amount (Number)

Examples

Example 1:
private _unitUniqueItems = uniqueUnitItems [player, 0, 2, 2, 2, true]; if (_unitUniqueItems getOrDefault ["FirstAidKit", 0] > 5) then { hint "I'm rich of FAK to give!"; };
Example 2:
private _unitUniqueItems = uniqueUnitItems [cursorObject];

Additional Information

See also:
getUnitLoadout

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