---
name: "inAreaArray"
type: command
status: ok
groups: ["Triggers", "Markers", "Locations", "Positions"]
arma3_since: "1.66"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/inAreaArray
revid: 378040
updated: 2026-01-27T13:05:40Z
---

# inAreaArray

*Command · Triggers, Markers, Locations, Positions · Arma 3 v1.66*

## Description

Returns given list of [Object](../topics/Object.md)s and/or [Position](../topics/Position.md)s that are in the given area, area defined by a trigger, marker, location or array.

> [!IMPORTANT]
> By default all positions given as [Array](../topics/Array.md) or as objects are treated as [PositionAGL](../topics/Position.md). Since Arma 3 v2.20 there is an option to force them to [PositionWorld](../topics/Position.md) format.

## Syntax

### Syntax 1

```sqf
positions inAreaArray area
```

**Parameters:**

- `positions`: [Array](../topics/Array.md) of [Object](../topics/Object.md)s and/or [Position](../topics/Position.md)s
- `area`: [Object](../topics/Object.md), [Location](../topics/Location.md) or [String](../topics/String.md) - the defined area:
  - [Object](../topics/Object.md) - trigger
  - [Location](../topics/Location.md) - location
  - [String](../topics/String.md) - marker name

**Returns:** [Array](../topics/Array.md) of [Object](../topics/Object.md)s and/or [Position](../topics/Position.md)s

### Syntax 2

```sqf
positions inAreaArray [centre, a, b, angle, isRectangle, c, usePosWorld]
```

**Parameters:**

- `positions`: [Array](../topics/Array.md) of [Object](../topics/Object.md)s and/or [Position](../topics/Position.md)s - Places to check. [Position](../topics/Position.md)s must be [PositionAGL](../topics/Position.md#positionagl) if area is checked in 3D (see note in description)
- `centre`: [Position2D](../topics/Position.md#introduction), [PositionAGL](../topics/Position.md#positionagl), Arma 3 v2.14 [Object](../topics/Object.md) or [Group](../topics/Group.md)
- `a`: [Number](../topics/Number.md) - x axis (x / 2)
- `b`: [Number](../topics/Number.md) - y axis (y / 2)
- `angle`: [Number](../topics/Number.md) - (Optional, default 0) rotation angle
- `isRectangle`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md)) [true](../commands/true.md) if rectangle, [false](../commands/false.md) if ellipse
- `c`: [Number](../topics/Number.md) - (Optional, default -1: unlimited) z axis (z / 2)
- `usePosWorld`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md)) set to [true](../commands/true.md) to treat all positions as [PositionWorld](../topics/Position.md) *(since Arma3 2.20)*

**Returns:** [Array](../topics/Array.md) of [Object](../topics/Object.md)s and/or [Position](../topics/Position.md)s

### Syntax 3

*since arma3 2.20*

```sqf
positions inAreaArray [pos1, pos2, pos3,...]
```

**Parameters:**

- `positions`: [Array](../topics/Array.md) of [Object](../topics/Object.md)s and/or [Position](../topics/Position.md)s - places to check.
- `posN`: [Position](../topics/Position.md) - polygon vertices in 2d or 3d format (see [inPolygon](../commands/inPolygon.md))

**Returns:** [Array](../topics/Array.md) of [Object](../topics/Object.md)s and/or [Position](../topics/Position.md)s

## Examples

### Example 1

```sqf
vehicles inAreaArray myTrigger;
```

### Example 2

```sqf
allUnits inAreaArray "myMarker";
```

### Example 3

```sqf
allPlayers inAreaArray myLocation;
```

### Example 4

```sqf
allDead inAreaArray [[100, 100, 0], 20, 30, 45, false, 10];
```

## See also

[inAreaArrayIndexes](../commands/inAreaArrayIndexes.md) · [inArea](../commands/inArea.md) · [triggerArea](../commands/triggerArea.md)

## Community notes

**Tankbuster** — 2017-06-11

The array you send the command can be filtered. For example:

```sqf
vehicles select { _x isKindOf "StaticWeapon" } inAreaArray "myMarker"
```

Will return only the statics inside the given marker.

<sub>Source: [BI Community Wiki — inAreaArray](https://community.bistudio.com/wiki/inAreaArray) (revision 378040).</sub>