emptyPositions: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Add positions back)
No edit summary
 
(10 intermediate revisions by 3 users not shown)
Line 20: Line 20:
|gr2= Unit Control
|gr2= Unit Control


|descr= Returns the number of given positions in the vehicle.
|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]]
|p1= vehicle: [[Object]]


|p2= position: [[String]] - can be one of:
|p2= position: [[String]] - can be one of:
{{Columns|2|
* {{hl|"Commander"}}
* {{hl|"Commander"}}
* {{hl|"Driver"}}
* {{hl|"Driver"}}
* {{hl|"Gunner"}}
* {{hl|"Gunner"}}
* {{hl|"Cargo"}}
* {{hl|"Cargo"}} - all cargo positions, FFV or not
* {{GVI|arma3|2.10|size= 0.75}} {{hl|""}} - all empty positions
* {{GVI|arma3|2.10|size= 0.75}} {{hl|"CargoNoFFV"}} - non-FFV cargo
* {{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]]
|r1= [[Number]]


|x1= <sqf>_freeCargoPositions = vehicle player emptyPositions "cargo";</sqf>
|x1= <sqf>_freeCargoAndFFVPositions = vehicle player emptyPositions "Cargo";</sqf>
 
|x2= <sqf>_freeCargoOnlyPositions = vehicle player emptyPositions "CargoNoFFV";</sqf>


|seealso= [[moveInDriver]] [[moveInTurret]] [[moveInCommander]] [[moveInGunner]] [[moveInCargo]] [[getCargoIndex]]
|seealso= [[moveInDriver]] [[moveInTurret]] [[moveInCommander]] [[moveInGunner]] [[moveInCargo]] [[getCargoIndex]]
}}
{{Note
|user= DreadedEntity
|timestamp= 20220320000854
|text= '''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)
<br>I have not found a way to test for copilot in helicopters
}}
}}

Latest revision as of 19:16, 12 February 2023

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

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 ManipulationUnit Control

Syntax

Syntax:
vehicle emptyPositions position
Parameters:
vehicle: Object
position: String - can be one of:
  • "Commander"
  • "Driver"
  • "Gunner"
  • "Cargo" - all cargo positions, FFV or not
  • Arma 3 logo black.png2.10 "" - all empty positions
  • Arma 3 logo black.png2.10 "CargoNoFFV" - non-FFV cargo
  • Arma 3 logo black.png2.10 "CargoFFV" - FFV cargo
  • Arma 3 logo black.png2.14 "Turret" - empty turrets (no FFV turrets, they are included in "CargoFFV")
Return Value:
Number

Examples

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

Additional Information

See also:
moveInDriver moveInTurret moveInCommander moveInGunner moveInCargo getCargoIndex

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
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
Retrieved from "https://community.bistudio.com/wiki?title=emptyPositions&oldid=337586"