captiveNum: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| arma2 |Game name=
| arma2


|1.00|Game version=
|1.00


|arg= global|Multiplayer Arguments=
|arg= global


|gr1= Object Manipulation |GROUP1=
|gr1= Object Manipulation


|gr2= Sides |GROUP2=
|gr2= Sides


| Checks whether the unit is a [[captive]]. If the unit is a vehicle, its commander is checked instead.<br>
| Checks whether the unit is a [[captive]]. If the unit is a vehicle, its commander is checked instead.<br>
If a unit's captivity level was set as a [[Boolean]], then the returned number is either 0 (for [[false]]) or 1 (for [[true]]). |DESCRIPTION=
If a unit's captivity level was set as a [[Boolean]], then the returned number is either 0 (for [[false]]) or 1 (for [[true]]).


| [[captiveNum]] unit |SYNTAX=
| [[captiveNum]] unit


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


| [[Number]] - anything from 0 to value set by [[setCaptive]] alt syntax. A non zero value means [[captive]]. |RETURNVALUE=
| [[Number]] - anything from 0 to value set by [[setCaptive]] alt syntax. A non zero value means [[captive]].


|x1= <code>_captivity = [[captiveNum]] _unit;</code> |EXAMPLE1=
|x1= <code>_captivity = [[captiveNum]] _unit;</code>


|x2= <code>_unit [[setCaptive]] 1024;
|x2= <code>_unit [[setCaptive]] 1024;
[[hint]] [[str]] [[captive]] _unit; {{cc|true}}
[[hint]] [[str]] [[captive]] _unit; {{cc|true}}
[[hint]] [[str]] [[captiveNum]] _unit; {{cc|1024}}</code> |EXAMPLE2=
[[hint]] [[str]] [[captiveNum]] _unit; {{cc|1024}}</code>




| [[captive]], [[setCaptive]] |SEEALSO=
| [[captive]], [[setCaptive]]
}}
}}



Revision as of 00:12, 18 January 2021

Hover & click on the images for description

Description

Description:
Checks whether the unit is a captive. If the unit is a vehicle, its commander is checked instead.
If a unit's captivity level was set as a Boolean, then the returned number is either 0 (for false) or 1 (for true).
Groups:
Object ManipulationSides

Syntax

Syntax:
captiveNum unit
Parameters:
unit: Object
Return Value:
Number - anything from 0 to value set by setCaptive alt syntax. A non zero value means captive.

Examples

Example 1:
_captivity = captiveNum _unit;
Example 2:
_unit setCaptive 1024; hint str captive _unit; // true hint str captiveNum _unit; // 1024

Additional Information

See also:
captivesetCaptive

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

Notes

Bottom Section