BIS fnc objectSide: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <!-- (DIS)?CONTINUE Notes -->" to "")
m (Text replacement - "Side relations" to "Side Relations")
 
(28 intermediate revisions by the same user not shown)
Line 2: Line 2:


|game1= arma3
|game1= arma3
|version1= 1.00
|version1= 1.00


Line 23: Line 22:
|r2= [[Side]]
|r2= [[Side]]


|x1= <code>_realVehicleSide = [<nowiki/>[[vehicle]] [[player]], [[true]]] [[call]] [[BIS_fnc_objectSide]];</code>
|x1= <sqf>private _realVehicleSide = [vehicle player, true] call BIS_fnc_objectSide;</sqf>


|x2= <code>_unknownSide = [<nowiki/>'''[[objNull]]''', [[false]]] [[call]] [[BIS_fnc_objectSide]]; {{cc|will return [[sideUnknown]]}}
|x2= <sqf>
_eastSide    = [<nowiki/>'''[[objNull]]''', [[true]]] &nbsp;[[call]] [[BIS_fnc_objectSide]]; {{cc|will return [[east]]}}</code>
private _unknownSide = [objNull, false] call BIS_fnc_objectSide; // will return sideUnknown
private _eastSide    = [objNull, true] call BIS_fnc_objectSide; // will return east
</sqf>


|x3= <code>{{cc|same results}}
|x3= <sqf>
_result1 = myVehicle [[call]] [[BIS_fnc_objectSide]];
// same results
_result2 = [myVehicle] [[call]] [[BIS_fnc_objectSide]];
_result1 = myVehicle call BIS_fnc_objectSide;
_result3 = [myVehicle, false] [[call]] [[BIS_fnc_objectSide]];</code>
_result2 = [myVehicle] call BIS_fnc_objectSide;
_result3 = [myVehicle, false] call BIS_fnc_objectSide;
</sqf>


|seealso= [[side]], [[CfgVehicles_Config_Reference#side|CfgVehicles config side value]], [[Side]], [[playerSide]], [[west]], [[east]], [[resistance]], [[civilian]], [[sideLogic]], [[sideFriendly]], [[sideEnemy]], [[sideUnknown]], [[sideEmpty]], [[sideAmbientLife]], [[Side relations]], [[BIS_fnc_sideID]]
|seealso= [[side]] [[CfgVehicles_Config_Reference#side|CfgVehicles config side value]] [[Side]] [[playerSide]] [[west]] [[east]] [[resistance]] [[civilian]] [[sideLogic]] [[sideFriendly]] [[sideEnemy]] [[sideUnknown]] [[sideEmpty]] [[sideAmbientLife]] [[Side Relations]] [[BIS_fnc_sideID]]
}}
}}


<dl class="command_description">
{{Note
<dt></dt>
|user= Tankbuster
<dd class="notedate">Posted on April 1, 2020 - 17:25 (UTC)</dd>
|timestamp= 20200401172500
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
|text= When using this to get the side of vehicle drivers, be aware that when the boolean parameter is true, empty vehicles will return their driver as east.
<dd class="note">
When using this to get the side of vehicle drivers, be aware that when the boolean parameter is true, empty vehicles will return their driver as east.
The same vehicle, when the boolean parameter is false, will return "UNKNOWN"
The same vehicle, when the boolean parameter is false, will return "UNKNOWN"
</dd>
}}
</dl>

Latest revision as of 21:02, 12 June 2023

Hover & click on the images for description

Description

Description:
Returns object side as defined in config (i.e. not affected by dynamic changing like rating)
Execution:
call
Groups:
Sides

Syntax

Syntax:
[target, boolean] call BIS_fnc_objectSide
Parameters:
target: Object - the object to be tested
boolean: Boolean (optional) - false (default) to return actual object side, true to return the default config value
Return Value:
Side

Alternative Syntax

Syntax:
target call BIS_fnc_objectSide
Parameters:
target: Object - the object to be tested. This syntax is equal to calling the method with false as a second parameter.
Return Value:
Side

Examples

Example 1:
private _realVehicleSide = [vehicle player, true] call BIS_fnc_objectSide;
Example 2:
private _unknownSide = [objNull, false] call BIS_fnc_objectSide; // will return sideUnknown private _eastSide = [objNull, true] call BIS_fnc_objectSide; // will return east
Example 3:
// same results _result1 = myVehicle call BIS_fnc_objectSide; _result2 = [myVehicle] call BIS_fnc_objectSide; _result3 = [myVehicle, false] call BIS_fnc_objectSide;

Additional Information

See also:
side CfgVehicles config side value Side playerSide west east resistance civilian sideLogic sideFriendly sideEnemy sideUnknown sideEmpty sideAmbientLife Side Relations BIS_fnc_sideID

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
Tankbuster - c
Posted on Apr 01, 2020 - 17:25 (UTC)
When using this to get the side of vehicle drivers, be aware that when the boolean parameter is true, empty vehicles will return their driver as east. The same vehicle, when the boolean parameter is false, will return "UNKNOWN"