emptyPositions: Difference between revisions

Latest revision as of 19:16, 12 February 2023

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:

"Commander"
"Driver"
"Gunner"
"Cargo" - all cargo positions, FFV or not
2.10 "" - all empty positions
2.10 "CargoNoFFV" - non-FFV cargo
2.10 "CargoFFV" - FFV cargo
2.14 "Turret" - empty turrets (no FFV turrets, they are included in "CargoFFV")

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 21: / Line 21: @@
 |descr= Returns the number of given empty positions in the vehicle.
-{{Feature | Informative | To return the actual units in the vehicle use [[fullCrew]]. However if only the number is desired, use '''emptyPositions''' because it is faster.}}
+{{Feature|informative|To return the actual units in the vehicle use [[fullCrew]]. However if only the number is desired, use [[emptyPositions]] because it is faster.}}
-|s1= vehicle [[emptyPositions ]] position
+|s1= vehicle [[emptyPositions]] position
 |p1= vehicle: [[Object]]
 |p2= position: [[String]] - can be one of:
+{{Columns|2|
 * {{hl|"Commander"}}
 * {{hl|"Driver"}}
 * {{hl|"Gunner"}}
-* {{hl|"Cargo"}} - CargoNoFFV + CargoFFV
+* {{hl|"Cargo"}} - all cargo positions, FFV or not
-* {{hl|""}} - all empty position (since 2.10)
+* {{GVI|arma3|2.10|size= 0.75}} {{hl|""}} - all empty positions
-* {{hl|"CargoNoFFV"}} - only cargo no FFV (since 2.10)
+* {{GVI|arma3|2.10|size= 0.75}} {{hl|"CargoNoFFV"}} - non-FFV cargo
-* {{hl|"CargoFFV"}} - only cargo FFV (since 2.10)
+* {{GVI|arma3|2.10|size= 0.75}} {{hl|"CargoFFV"}} - FFV cargo
+* {{GVI|arma3|2.14|size= 0.75}} {{hl|"Turret"}} - empty turrets (no FFV turrets, they are included in "CargoFFV")
+}}
 |r1= [[Number]]
 |x1= <sqf>_freeCargoAndFFVPositions = vehicle player emptyPositions "Cargo";</sqf>
 |x2= <sqf>_freeCargoOnlyPositions = vehicle player emptyPositions "CargoNoFFV";</sqf>