---
name: "BIS_fnc_position"
type: function
status: ok
groups: ["Positions"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_position
revid: 352042
updated: 2024-02-01T23:24:29Z
---

# BIS_fnc_position

*Function · Positions · Arma 3 v0.50 · introduced in Take On Helicopters v1.00*

## Description

Returns [PositionAGL](../topics/Position.md#positionagl), unless passed argument is [Array](../topics/Array.md), then the same array is returned. When position is [Object](../topics/Object.md) and alternative position is stored in `"BIS_fnc_position_forced"` variable on this object, the stored position is used rather than actual object position. This function is a pretty safe way to get the position of an entity.

## Syntax

```sqf
argument call BIS_fnc_position
```

**Parameters:**

- `argument` - could be one of:
  - [Array](../topics/Array.md) - Position in format `[x, y]` or `[x, y ,z]`
  - [Object](../topics/Object.md) - Object
  - [Group](../topics/Group.md) - Group, group leader position is used
  - [Location](../topics/Location.md) - Location
  - [String](../topics/String.md) - Marker or variable name containing object

  > [!NOTE]
  > To get the position of an Eden Entity use `_entity get3DENAttribute "Position" select 0;`.

**Returns:** [Array](../topics/Array.md) - position in format `[x, y]` or `[x, y ,z]`

## Examples

### Example 1

```sqf
private _pos = player call BIS_fnc_position;
```

## See also

[Position](../topics/Position.md)

<sub>Source: [BI Community Wiki — BIS fnc position](https://community.bistudio.com/wiki/BIS_fnc_position) (revision 352042).</sub>
