getAllUnitTraits: Difference between revisions

Latest revision as of 00:27, 30 April 2024

2.00

Hover & click on the images for description

Description

Description:: Returns unit traits (native or set by setUnitTrait).
Groups:: Object Manipulation

Syntax

Syntax:

getAllUnitTraits unit

Parameters:

unit: Object or

2.18 String - a unit or a class name

Return Value:

Array of Arrays in format [name, value] where:

name: String - trait's name
value String or Boolean - trait's value

Examples

Example 1:: private _playerTraits = getAllUnitTraits player; /* Could return something like this: [ ["Medic", false], ["Engineer", false], ["ExplosiveSpecialist", false], ["UavHacker", false], ["CamouflageCoef", 1], ["AudibleCoef", 1], ["LoadCoef", 1], ["test", "custom"] ] */
Example 2:: private _unitTraits = getAllUnitTraits _unit; private _indexes = [_unitTraits, "Medic"] call BIS_fnc_findNestedElement; private _unitCanHeal = _unitTraits select (_indexes select 0) select 1;
Example 3:: Since 2.18:
hint str getAllUnitTraits "O_Engineer_F"; /* [ ["Medic", false], ["Engineer", true], ["ExplosiveSpecialist", true], ["UavHacker", false], ["CamouflageCoef", 1], ["AudibleCoef", 1], ["LoadCoef", 1] ] */

Additional Information

See also:: getUnitTrait setUnitTrait

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

BrettMayson - c: Posted on Nov 27, 2023 - 02:54 (UTC)
: Local argument assumed, needs confirmation

@@ Line 2: / Line 2: @@
 |game1= arma3
 |version1= 2.00
+<!--
-|arg= <!-- local, to be confirmed -->
+|arg= local
+-->
-|eff=
-|serverExec=
 |gr1= Object Manipulation
-|descr= Returns unit traits, native or set by [[setUnitTrait]].
+|descr= Returns unit traits (native or set by [[setUnitTrait]]).
-|mp= |Multiplayer Behaviour=
-|pr= |Problems=
 |s1= [[getAllUnitTraits]] unit
-|p1= unit: [[Object]]
+|p1= unit: [[Object]] or {{GVI|arma3|2.18|size= 0.75}} [[String]] - a unit or a class name
-|r1= [[Array]] of [[Array]]s of [<nowiki/>[[String]], [[String]]/[[Boolean]]] - to format [["traitName1",value1], ["traitName2", value2]]
+|r1= [[Array]] of [[Array]]s in format [name, value] where:
+* name: [[String]] - trait's name
+* value [[String]] or [[Boolean]] - trait's value
-|x1= <code>{{codecomment|/* can return:
+|x1= <sqf>
+private _playerTraits = getAllUnitTraits player;
+/*
+Could return something like this:
 [
 	["Medic", false],
@@ Line 36: / Line 32: @@
 	["test", "custom"]
 ]
-<nowiki/>*/}}
+*/
-[[private]] _playerTraits = [[getAllUnitTraits]] [[player]];</code>
+</sqf>
-|x2= <code>[[private]] _unitTraits = [[getAllUnitTraits]] _unit;
+|x2= <sqf>
-[[private]] _indexes = [_unitTraits, "Medic"] [[call]] [[BIS_fnc_findNestedElement]];
+private _unitTraits = getAllUnitTraits _unit;
-[[private]] _unitCanHeal = _unitTraits [[select]] (_indexes [[select]] 0) [[select]] 1;</code>
+private _indexes = [_unitTraits, "Medic"] call BIS_fnc_findNestedElement;
+private _unitCanHeal = _unitTraits select (_indexes select 0) select 1;
+</sqf>
-|seealso= [[setUnitTrait]]
+|x3= Since {{GVI|arma3|2.18|size= 0.75}}:
+<sqf>
+hint str getAllUnitTraits "O_Engineer_F";
+/*
+[
+	["Medic", false],
+	["Engineer", true],
+	["ExplosiveSpecialist", true],
+	["UavHacker", false],
+	["CamouflageCoef", 1],
+	["AudibleCoef", 1],
+	["LoadCoef", 1]
+]
+*/
+</sqf>
+|seealso= [[getUnitTrait]] [[setUnitTrait]]
 }}
-<dl class="command_description">
+{{Note
-<!-- BEGIN Note Section -->
+|user= BrettMayson
-<!-- For example:
+|timestamp= 20231127025400
-<dd class="notedate">Posted on Month Day, Year - Time (UTC)</dd>
+|text= Local argument assumed, needs confirmation
-<dt class="note">[[User:User Name|User Name]]</dt>
+}}
-<dd class="note">This is an example note. It is true and verifiable, and contains a little code snippet.
-<code>[[if]] ([[_this]] == anExample) [[then]] { [[hint]] "Leave it here for others to read"; };</code></dd>
--->
-<!-- END Note Section -->
-</dl>