# isKeyBound (Compartilhado)

> Diz se este recurso ligou uma função a uma tecla.

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

## Sintaxe

```lua
bool isKeyBound(player thePlayer, string key [, string keyState = both, function handler = nil])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `thePlayer` | `player` | Só no servidor: o jogador dono do bind. No cliente, não passe este argumento. |
| `key` | `string` | O nome da tecla, sem diferença entre maiúsculas e minúsculas: `a` a `z`, `0` a `9`, `F1` a `F12`, `mouse1` a `mouse5`, `mouse_wheel_up`, `mouse_wheel_down`, `arrow_l`, `num_0`, `space`, `enter`, `lshift` e outras. |
| `keyState` | `string` | Que bind procurar: `"down"`, `"up"` ou `"both"`. *(padrão: `both`)* |
| `handler` | `function` | A função a procurar. Sem ela, qualquer função vale. *(padrão: `nil`)* |

## Retorno

`true` se há um bind de função deste recurso na tecla, `false` caso contrário.

Só os binds de função contam: um comando ligado à tecla não é visto.

## Exemplo

```lua
local function honk()
    outputDebugString("beep")
end

if not isKeyBound("h", "down", honk) then
    bindKey("h", "down", honk)
end
```

## Veja também

- [bindKey (Compartilhado)](https://wiki.mymp.gg/pt/bindKey.md): Liga uma tecla a uma função ou a um comando. A função roda quando a tecla é apertada, solta ou os dois.
- [unbindKey (Compartilhado)](https://wiki.mymp.gg/pt/unbindKey.md): Desfaz binds que este recurso criou numa tecla.
- [getFunctionsBoundToKey (Compartilhado)](https://wiki.mymp.gg/pt/getFunctionsBoundToKey.md): Lista as funções que este recurso ligou a uma tecla.
