canAdd: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "{{Command " to "{{RV|type=command ")
m (Text replacement - " *\| *PARAMETER[0-9]{1,3} *= * " to " ")
Line 19: Line 19:
|s2= object [[canAdd]] [item, count] {{Since|arma3|1.55.133607|y}}
|s2= object [[canAdd]] [item, count] {{Since|arma3|1.55.133607|y}}


|p21= object: [[Object]] - unit or container |PARAMETER21=
|p21= object: [[Object]] - unit or container


|p22= [item, count]: [[Array]] |PARAMETER22=
|p22= [item, count]: [[Array]]


|p23= item: [[String]] - Config class |PARAMETER23=
|p23= item: [[String]] - Config class


|p24= count: [[Number]] - desired quantity |PARAMETER24=
|p24= count: [[Number]] - desired quantity


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

Revision as of 19:09, 29 January 2021

Hover & click on the images for description

Description

Description:
Description needed
Groups:
Unit Inventory

Syntax

Syntax:
Syntax needed
Parameters:
object: Object - unit or container
item: String - Config class
Return Value:
Return value needed

Alternative Syntax

Syntax:
object canAdd [item, count] Template:Since
Parameters:
object: Object - unit or container
[item, count]: Array
item: String - Config class
count: Number - desired quantity
Return Value:
Boolean

Examples

Example 1:
if (player canAdd "FirstAidKit") then { player addItem "FirstAidKit"; } else { hint "Not enough space"; };
Example 2:
if (_box canAdd "FirstAidKit") then { _box addWeaponCargo ["FirstAidKit", 1]; } else { hint "Not enough space"; };
Example 3:
car canAdd [currentWeapon player, 50];

Additional Information

See also:
See also needed

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
Posted on November 29, 2015 - 00:02 (UTC)
Jonpas
Can also be used on any object that has inventory, not only player inventory containers.

Where _box is B_supplyCrate_F: // Empty _box canAdd "FirstAidKit"; -> true // Full _box canAdd "FirstAidKit"; -> false
Posted on February 11, 2017 - 18:40 (UTC)
Demellion
This can also be used as alternative to canAddItemToBackpack, canAddItemToUniform, canAddItemToVest where container might not be strictly defined.In some cases it might be a good optimisation for your code, where you also don't need to perform checks on which type of player container this is. Example:
_i = [(uniformContainer player),(vestContainer player),(backpackContainer player)] call BIS_fnc_selectRandom; if (_i canAdd "Rangefinder") then { _i addItemCargoGlobal ["Rangefinder",1]; };