canAddItemToUniform: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " {3,}\|" to " |")
m (Some wiki formatting)
 
(32 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


| arma3
|game1= arma3
|version1= 1.04


|1.04
|gr1= Unit Inventory


|gr1= Unit Inventory
|descr= Checks if given object can be stored into soldier's uniform.


| Checks if given object can be stored into soldier's uniform.
{{Feature|important|
Avoid passing an empty string <sqf inline>""</sqf> to this command as it will create a warning dialog:
[[File:a3 warning badvehicletype.jpg|none|alt= Warning Message: Bad vehicle type|Warning Message: Bad vehicle type]]
This message will show once per mission restart.
}}


| unit [[canAddItemToUniform]] item
|s1= unit [[canAddItemToUniform]] item


|p1= unit: [[Object]]
|p1= unit: [[Object]]
Line 15: Line 20:
|p2= item: [[String]]
|p2= item: [[String]]


| [[Boolean]]
|r1= [[Boolean]]


|s2= unit [[canAddItemToUniform]] [item, count] {{Since|arma3|1.55.133607|y}}
|s2= unit [[canAddItemToUniform]] [item, count, ignoreSoldierMaxLoad]


|p21= unit: [[Object]]  |PARAMETER21=
|s2since= arma3 1.56


|p22= [item, count]: [[Array]] |PARAMETER22=
|p21= unit: [[Object]]


|p23= item: [[String]] |PARAMETER23=
|p22= item: [[String]]


|p24= count: [[Number]] |PARAMETER24=
|p23= count: [[Number]]
 
|p24= ignoreSoldierMaxLoad (Optional): [[Boolean]] - [[true]] to ignore 'soldierMaxLoad' param, container [[maxLoad]] is still counted. Default: [[false]]
|p24since= arma3 2.18


|r2= [[Boolean]]
|r2= [[Boolean]]


|x1= <code>_item = "HandGrenade";
|x1= <sqf>
_fits = [[player]] [[canAddItemToUniform]] _item;
_item = "HandGrenade";
[[if]] (_fits) [[then]] {
_fits = player canAddItemToUniform _item;
[[player]] [[addItemToUniform]] _item;
if (_fits) then
} [[else]] {
{
[[hint]] "no room!";
player addItemToUniform _item;
};</code>
}
 
else
| [[canAdd]], [[canAddItemToBackpack]], [[canAddItemToVest]]
{
hint "no room!";
};
</sqf>


|seealso= [[canAdd]] [[canAddItemToBackpack]] [[canAddItemToVest]]
}}
}}
{{GameCategory|arma3|New Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 11:33, 3 September 2024

Hover & click on the images for description

Description

Description:
Checks if given object can be stored into soldier's uniform.
Avoid passing an empty string "" to this command as it will create a warning dialog:
Warning Message: Bad vehicle type
This message will show once per mission restart.
Groups:
Unit Inventory

Syntax

Syntax:
unit canAddItemToUniform item
Parameters:
unit: Object
item: String
Return Value:
Boolean

Alternative Syntax

Syntax:
unit canAddItemToUniform [item, count, ignoreSoldierMaxLoad]
Parameters:
unit: Object
item: String
count: Number
since Arma 3 logo black.png2.18
ignoreSoldierMaxLoad (Optional): Boolean - true to ignore 'soldierMaxLoad' param, container maxLoad is still counted. Default: false
Return Value:
Boolean

Examples

Example 1:
_item = "HandGrenade"; _fits = player canAddItemToUniform _item; if (_fits) then { player addItemToUniform _item; } else { hint "no room!"; };

Additional Information

See also:
canAdd canAddItemToBackpack canAddItemToVest

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