---
name: "BIS_fnc_objectSide"
type: function
status: ok
groups: ["Sides"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_objectSide
revid: 341640
updated: 2023-06-12T19:02:56Z
---

# BIS_fnc_objectSide

*Function · Sides · Arma 3 v1.00*

## Description

Returns object side as defined in config (i.e. not affected by dynamic changing like rating)

## Syntax

### Syntax 1

```sqf
[target, boolean] call BIS_fnc_objectSide
```

**Parameters:**

- `target`: [Object](../topics/Object.md) - the object to be tested
- `boolean`: [Boolean](../topics/Boolean.md) (optional) - false (default) to return actual object side, true to return the default config value

**Returns:** [Side](../topics/Side.md)

### Syntax 2

```sqf
target call BIS_fnc_objectSide
```

**Parameters:**

- `target`: [Object](../topics/Object.md) - the object to be tested. This syntax is equal to calling the method with [false](../commands/false.md) as a second parameter.

**Returns:** [Side](../topics/Side.md)

## Examples

### Example 1

```sqf
private _realVehicleSide = [vehicle player, true] call BIS_fnc_objectSide;
```

### Example 2

```sqf
private _unknownSide = [objNull, false] call BIS_fnc_objectSide; // will return sideUnknown
private _eastSide    = [objNull, true]  call BIS_fnc_objectSide; // will return east
```

### Example 3

```sqf
// same results
_result1 = myVehicle call BIS_fnc_objectSide;
_result2 = [myVehicle] call BIS_fnc_objectSide;
_result3 = [myVehicle, false] call BIS_fnc_objectSide;
```

## See also

[side](../commands/side.md) · CfgVehicles Config Reference · [Side](../topics/Side.md) · [playerSide](../commands/playerSide.md) · [west](../commands/west.md) · [east](../commands/east.md) · [resistance](../commands/resistance.md) · [civilian](../commands/civilian.md) · [sideLogic](../commands/sideLogic.md) · [sideFriendly](../commands/sideFriendly.md) · [sideEnemy](../commands/sideEnemy.md) · [sideUnknown](../commands/sideUnknown.md) · [sideEmpty](../commands/sideEmpty.md) · [sideAmbientLife](../commands/sideAmbientLife.md) · Side Relations · [BIS_fnc_sideID](../functions/BIS_fnc_sideID.md)

## Community notes

**Tankbuster** — 2020-04-01

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"

<sub>Source: [BI Community Wiki — BIS fnc objectSide](https://community.bistudio.com/wiki/BIS_fnc_objectSide) (revision 341640).</sub>