# removeEventHandler (Compartilhado)

> Tira uma função de um evento de um elemento, onde ela foi posta com `addEventHandler`.

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

## Sintaxe

```lua
bool removeEventHandler(string eventName, element attachedTo, function handler)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `eventName` | `string` | Nome do evento. |
| `attachedTo` | `element` | O mesmo elemento passado a `addEventHandler`. |
| `handler` | `function` | A mesma função passada a `addEventHandler`. |

## Retorno

`true` se removeu, `false` se essa função não estava nesse evento desse elemento.

Um handler removido enquanto o evento já está rodando não é mais chamado nesse disparo.

## Exemplo

```lua
local function onFirstSpawn()
    outputDebugString(getPlayerName(source) .. " nasceu pela primeira vez")
    removeEventHandler("onPlayerSpawn", source, onFirstSpawn)
end

addEventHandler("onPlayerJoin", root, function()
    addEventHandler("onPlayerSpawn", source, onFirstSpawn)
end)
```

## Veja também

- [addEventHandler (Compartilhado)](https://wiki.mymp.gg/pt/addEventHandler.md): Faz uma função ser chamada sempre que o evento acontece no elemento indicado ou, com propagate, em qualquer descendente dele.
- [getEventHandlers (Compartilhado)](https://wiki.mymp.gg/pt/getEventHandlers.md): Lista as funções que este recurso pôs num evento de um elemento com addEventHandler.
