View source for PT-BR/GetPedWeapon

__NOTOC__
{{BR/Função compartilhada}}
Essa função informa qual o tipo de arma que está em um certo '''[[weapon|weapon slot]]''' de um jogador.

==Sintaxe==
<syntaxhighlight lang="lua">
int getPedWeapon ( ped thePed, [ int weaponSlot = current ] )
</syntaxhighlight>
{{OOP||[[ped]]:getWeapon}}

===Argumentos Necessários===
*'''thePed''': O [[ped]] que você deseja obter o tipo de arma.

===Argumentos Opcionais===
*'''weaponSlot''': um inteiro representando o [[weapon|weapon slot]] (definido para o slot atual do jogador se não for indicado).

===Retornos===
Retorna um [[int]] indicando o tipo da arma que o jogador tem no slot especificado. Se o slot estiver vazio, ele retornará 0.

Deve-se notar que se um jogador ficar sem munição para uma arma, ele ainda retornará o ID dessa arma no slot (mesmo que o jogador não tenha nenhuma arma), embora [[getPedTotalAmmo]] retorne '''0'''. Portanto, [[getPedTotalAmmo]] deve ser usado em conjunto com [[getPedWeapon]] para verificar se um jogador tem a arma. 

==Exemplos==
Esse exemplo irá exibir o tipo da arma atual de um jogador. Nesse caso, um jogador aleatório.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
--
-- Encontrar um jogador (aleatório) e pegar o id da arma atual.
local weaponType = getPedWeapon ( getRandomPlayer() )
-- Se um tipo de arma for retornado, então
if ( weaponType ) then
    outputChatBox ( "Tipo de arma atual de algum jogador: " .. weaponType .. "." ) -- Exibir o tipo da arma no bate-papo.
end
</syntaxhighlight>
</section>

==Veja também==
{{Client_ped_functions}}

[[en:getPedWeapon]]