emptyPositions

Arma 3 v0.50
First in Armed Assault v1.00

Command · also in Unit Control · Markdown · JSON · original wiki page

Description

Returns the number of given empty positions in the vehicle.

Note
To return the actual units in the vehicle use fullCrew. However if only the number is desired, use emptyPositions because it is faster.

Syntax

Syntax 1

vehicle emptyPositions position

Parameters:

vehicle: Object - transport
position: String - can be one of:
- "Commander"
- "Driver"
- "Gunner"
- "Cargo" - all cargo positions, FFV or not
- Arma 3 v2.10 "" - all empty positions
- Arma 3 v2.10 "CargoNoFFV" - non-FFV cargo
- Arma 3 v2.10 "CargoFFV" - FFV cargo
- Arma 3 v2.14 "Turret" - empty turrets (no FFV turrets, they are included in "CargoFFV")

Returns: Number - the number of available positions ignoring locked positions

Syntax 2

since arma3 2.22

vehicle emptyPositions [position, ignoreLocked]

Parameters:

vehicle: Object - transport
position: String - see moveInAny. Empty string "" returns number of all free positions
ignoreLocked (Optional): Boolean - true to ignore locked positions. Default: false

Returns: Number - the number of available positions ignoring locked positions

Examples

Example 1

_freeCargoAndFFVPositions = vehicle player emptyPositions "Cargo";

Example 2

_freeCargoOnlyPositions = vehicle player emptyPositions "CargoNoFFV";

Community notes

DreadedEntity

2022-03-20

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