emptyPositions: Difference between revisions

From Bohemia Interactive Community
mNo edit summary
No edit summary
 
(67 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|version1= 1.00


|2.92|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Returns the number of available cargo, driver, gunner or commander positions in the vehicle. |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| vehicle '''emptyPositions''' position |= Syntax
|game4= tkoh
|version4= 1.00


|p1= vehicle [[Object]] |= Parameter 1
|game5= arma3
|version5= 0.50


|p2= position [[String]] |= Parameter 2
|gr1= Object Manipulation


| [[Number]] |= Return value
|gr2= Unit Control
____________________________________________________________________________________________
 
|x1= <pre>_freePositions = ([[vehicle]] [[player]]) emptyPositions "cargo"</pre> |= Example 1
____________________________________________________________________________________________


| |= See also
|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.}}


|s1= vehicle [[emptyPositions]] position
|p1= vehicle: [[Object]]
|p2= position: [[String]] - can be one of:
{{Columns|2|
* {{hl|"Commander"}}
* {{hl|"Driver"}}
* {{hl|"Gunner"}}
* {{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")
}}
}}


<h3 style="display:none">Notes</h3>
|r1= [[Number]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x1= <sqf>_freeCargoAndFFVPositions = vehicle player emptyPositions "Cargo";</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|x2= <sqf>_freeCargoOnlyPositions = vehicle player emptyPositions "CargoNoFFV";</sqf>


[[Category:Scripting Commands|EMPTYPOSITIONS]]
|seealso= [[moveInDriver]] [[moveInTurret]] [[moveInCommander]] [[moveInGunner]] [[moveInCargo]] [[getCargoIndex]]
[[Category:Scripting Commands ArmA|EMPTYPOSITIONS]]
}}
 
{{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.png 1.00Logo A2.png 1.00A2 OA Logo.png 1.50tkoh logo small.png 1.00Arma 3 logo black.png 0.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.png 2.10 "" - all empty positions
  • Arma 3 logo black.png 2.10 "CargoNoFFV" - non-FFV cargo
  • Arma 3 logo black.png 2.10 "CargoFFV" - FFV cargo
  • Arma 3 logo black.png 2.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"