emptyPositions: Difference between revisions

Revision as of 11:15, 10 April 2022

Hover & click on the images for description

Description:: Returns the number of given positions in the vehicle.
ⓘ
To return the actual units in the vehicle use fullCrew. However if only the number is desired, use emptyPositions because it is faster.
Groups:: Object Manipulation Unit Control

Syntax:

vehicle emptyPositions position

Parameters:

vehicle: Object

position: String - can be one of:

Return Value:

Number

Syntax:: vehicle emptyPositions [position, filter]
Parameters:: vehicle: Object
: filter: Boolean - true: Cargo only, false: FFV only, ommited: Cargo+FFV (Default)
Return Value:: Number

Example 1:: _freeCargoAndFFVPositions = vehicle player emptyPositions "cargo";
Example 2:: _freeCargoOnlyPositions = vehicle player emptyPositions ["cargo", true];

See also:: moveInDriver moveInTurret moveInCommander moveInGunner moveInCargo getCargoIndex

: 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

DreadedEntity - c: Posted on Mar 20, 2022 - 00:08 (UTC)
: emptyPositions combines both turret and cargo in its output. If you must know the true count of either, you will have to use fullCrew (tested on several vehicles)
I have not found a way to test for copilot in helicopters

@@ Line 31: / Line 31: @@
 * {{hl|"Driver"}}
 * {{hl|"Gunner"}}
-* {{hl|"Cargo"}}
+* {{hl|"Cargo"}} - Cargo + FFV
+* {{hl|""}} - all empty position (since 2.10)
 |r1= [[Number]]
-|x1= <sqf>_freeCargoPositions = vehicle player emptyPositions "cargo";</sqf>
+|s2= vehicle [[emptyPositions ]] [position, filter]
+|s2since= Arma3 2.10
+|p21= vehicle: [[Object]]
+|p22= position: [[String]] - can be one of:
+* {{hl|"Commander"}}
+* {{hl|"Driver"}}
+* {{hl|"Gunner"}}
+* {{hl|"Cargo"}} - Cargo/FFV/Cargo+FFV (depends on 'filter' value)
+* {{hl|""}} - all empty position (depends on 'filter' value)
+|p22= filter: [[Boolean]] - [[true]]: Cargo only, [[false]]: FFV only, ommited: Cargo+FFV (Default)
+|r2= [[Number]]
+|x1= <sqf>_freeCargoAndFFVPositions = vehicle player emptyPositions "cargo";</sqf>
+|x2= <sqf>_freeCargoOnlyPositions = vehicle player emptyPositions ["cargo", true];</sqf>
 |seealso= [[moveInDriver]] [[moveInTurret]] [[moveInCommander]] [[moveInGunner]] [[moveInCargo]] [[getCargoIndex]]