assignedItems: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]3(\|.*)]]" to "{{GameCategory|arma3|Scripting Commands}}")
m (Some wiki formatting)
 
(41 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 0.50


|0.50|Game version=
|gr1= Unit Inventory


|gr1= Unit Inventory |GROUP1=
|descr= Get array with assigned items. The resulting [[Array]] order is not guaranteed.
____________________________________________________________________________________________
To check availability of a particular slot item use [[getSlotItemName]].
To return stored items see [[items]] and [[itemsWithMagazines]].


| Get array with all assigned items. The resulting Array is sorted like: [<Map>, <Compass>, <Watch>, <Radio>, <GPS>, <NVG>, <Binoculars>]. But if something is missing it get's omitted so you can not be sure that some element is at a constant index. To return stored items see [[items]] and [[itemsWithMagazines]].
|s1= [[assignedItems]] unit
|DESCRIPTION=
____________________________________________________________________________________________


| '''assignedItems''' unit |SYNTAX=
|p1= unit: [[Object]]


|p1= unit: [[Object]] |PARAMETER1=
|r1= [[Array]] of [[String]]s


| [[Array]] |RETURNVALUE=  
|s2= [[assignedItems]] [unit, allItems, includeBinocs]
|s2since= arma3 2.14


|p21= unit: [[Object]] - soldier


|x1= <code> [[hint]] [[str]] [[assignedItems]] [[player]];</code>|EXAMPLE1=
|p22= allItems: [[Boolean]] - [[true]] to include all slot items, [[false]] exclude goggles and headgear


____________________________________________________________________________________________
|p23= includeBinocs: [[Boolean]] - [[true]] to include binoculars (which is a weapon), [[false]] to exclude it


| [[assignItem]], [[unassignItem]], [[linkItem]], [[unlinkItem]], [[addItem]], [[removeItem]], [[removeAllAssignedItems]], [[items]], [[itemsWithMagazines]] |SEEALSO=
|r2= [[Array]] of [[String]]s


| |MPBEHAVIOUR=  
|x1= <sqf>hint str assignedItems player;</sqf>
____________________________________________________________________________________________
 
|seealso= [[getSlotItemName]] [[assignItem]] [[unassignItem]] [[linkItem]] [[unlinkItem]] [[addItem]] [[removeItem]] [[removeAllAssignedItems]] [[items]] [[itemsWithMagazines]] [[backpacks]]
}}
}}


<h3 style='display:none'>Notes</h3>
{{Note
<dl class='command_description'>
|user= Druid
<!-- Note Section BEGIN -->
|timestamp= 20130618142600
|text= Arma 3, version 0.70 - headgear and goggles are not present in returned array now.
}}


<dd class="notedate">Posted on June 18, 2013 - 14:20
{{Note
<dt class="note">[[User:Druid|Druid]]<dd class="note">Arma 3, version 0.70 - headgear and goggles are not present in returned array now.<br>
|user= Killzone_Kid
 
|timestamp= 20130822175200
<dd class="notedate">Posted on August 22, 2013 - 17:50
|text= For head gear use [[headgear]], [[addHeadgear]] and [[removeHeadgear]]. For goggles use [[goggles]], [[addGoggles]] and [[removeGoggles]]
<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]<dd class="note">For head gear use [[headgear]], [[addHeadgear]] and [[removeHeadgear]]. For goggles use [[goggles]], [[addGoggles]] and [[removeGoggles]]<br>
}}
 
<!-- Note Section END -->
</dl>
 
<h3 style='display:none'>Bottom Section</h3>
{{GameCategory|arma3|New_Scripting_Commands_List}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 09:06, 3 March 2026

Arma 3 logo black.png 0.50
Hover & click on the images for description

Description

Description:
Get array with assigned items. The resulting Array order is not guaranteed. To check availability of a particular slot item use getSlotItemName. To return stored items see items and itemsWithMagazines.
Groups:
Unit Inventory

Syntax

Syntax:
assignedItems unit
Parameters:
unit: Object
Return Value:
Array of Strings

Alternative Syntax

Syntax:
assignedItems [unit, allItems, includeBinocs]
Parameters:
unit: Object - soldier
allItems: Boolean - true to include all slot items, false exclude goggles and headgear
includeBinocs: Boolean - true to include binoculars (which is a weapon), false to exclude it
Return Value:
Array of Strings

Examples

Example 1:
hint str assignedItems player;

Additional Information

See also:
getSlotItemName assignItem unassignItem linkItem unlinkItem addItem removeItem removeAllAssignedItems items itemsWithMagazines backpacks

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note
Druid - c
Posted on Jun 18, 2013 - 14:26 (UTC) §
Arma 3, version 0.70 - headgear and goggles are not present in returned array now.
Killzone_Kid - c
Posted on Aug 22, 2013 - 17:52 (UTC) §
For head gear use headgear, addHeadgear and removeHeadgear. For goggles use goggles, addGoggles and removeGoggles
Retrieved from "https://community.bistudio.com/wiki?title=assignedItems&oldid=378170"