# getElementsInRange (Compartilhado)

> Lista os elementos cuja posição está dentro de uma esfera.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Elementos
- **URL**: https://wiki.mymp.gg/pt/getElementsInRange

## Sintaxe

```lua
table getElementsInRange(float x, y, z, float radius [, string type = "", int interior = -1, int dimension = -1])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y, z` | `float` | Centro da esfera. |
| `radius` | `float` | Raio em metros. Um número negativo dá erro. |
| `type` | `string` | Só elementos deste tipo. Vazio aceita qualquer tipo. *(padrão: `""`)* |
| `interior` | `int` | Só elementos neste interior. `-1` aceita qualquer interior. *(padrão: `-1`)* |
| `dimension` | `int` | Só elementos nesta dimensão. `-1` aceita qualquer dimensão. *(padrão: `-1`)* |

## Retorno

Uma tabela com os elementos encontrados, vazia se não há nenhum.

Elementos sem posição nunca entram. Ao filtrar por interior, os que não têm interior ficam de fora.

## Exemplo

```lua
local pos = getElementPosition(localPlayer)
local nearby = getElementsInRange(pos, 30, "vehicle", 0, getElementDimension(localPlayer))
outputDebugString(#nearby .. " veículos por perto")
```

### Vindo do MTA

No MTA esta função se chama `getElementsWithinRange`.

## Veja também

- [getElementsByType (Servidor)](https://wiki.mymp.gg/pt/getElementsByType-server.md): Lista todos os elementos de um tipo abaixo de um elemento da árvore no servidor.
- [getElementPosition (Compartilhado)](https://wiki.mymp.gg/pt/getElementPosition.md): Lê a posição de um elemento no mundo.