emptyPositions: Difference between revisions

Revision as of 21:37, 10 April 2022

Hover & click on the images for description

Description:: Returns the number of given empty 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

Example 1:: _freeCargoAndFFVPositions = vehicle player emptyPositions "Cargo";
Example 2:: _freeCargoOnlyPositions = vehicle player emptyPositions "CargoNoFFV";

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"}} - Cargo + FFV
+* {{hl|"Cargo"}} - CargoNoFFV + CargoFFV
 * {{hl|""}} - all empty position (since 2.10)
+* {{hl|"CargoNoFFV"}} - only cargo no FFV (since 2.10)
+* {{hl|"CargoFFV"}} - only cargo FFV (since 2.10)
 |r1= [[Number]]
-|s2= vehicle [[emptyPositions ]] [position, filter]
+|x1= <sqf>_freeCargoAndFFVPositions = vehicle player emptyPositions "Cargo";</sqf>
-|s2since= Arma3 2.10
+|x2= <sqf>_freeCargoOnlyPositions = vehicle player emptyPositions "CargoNoFFV";</sqf>
-|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)
-|p23= 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]]