GetPlayerName

2022-04-20T14:42:41Z

KoADEV: Undo revision 74472 by KoADEV (talk)

__NOTOC__
{{Server client function}}
This function returns a string containing the name of the specified player.

==Syntax==
<syntaxhighlight lang="lua">
string getPlayerName ( player thePlayer )
</syntaxhighlight>
{{OOP||[[player]]:getName|name|setPlayerName}}
===Required Arguments===
* '''thePlayer:''' the [[player]] you want to get the name of

===Returns===
Returns a string containing the requested player's name, or ''false'' if the player passed to the function is invalid.

===Limits===
* Player name can consist of ASCII characters between 33 and 126 are allowed (basic latin):
<nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~</nowiki>
* Minimal player name length is 1 character.
* Maximum player name length is 22 characters.
* Player names are case-insensitive. It is not possible to have two clients with same name but different character case.

==Example==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("myname",
function(playerSource)
outputChatBox("Your name: "..getPlayerName(playerSource), playerSource)
end
)
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
This example outputs the local player name to the chatbox.
<syntaxhighlight lang="lua">
addCommandHandler("myname",
function()
local localPlayerName = getPlayerName(getLocalPlayer())
--and we output it to the chatbox
outputChatBox(localPlayerName)
end
)
</syntaxhighlight>
</section>

==See Also==
{{Client player functions}}
[[es:getPlayerName]]
[[pt-br:getPlayerName]]

GetPlayerName

2022-04-20T14:39:26Z

KoADEV:

__NOTOC__
{{BR/Função compartilhada}}
Essa função retorna uma string contendo o nome do player especificado.

==Sintaxe==
<syntaxhighlight lang="lua">
string getPlayerName ( player thePlayer )
</syntaxhighlight>
{{PT-BR/POO||[[player]]:getName|name|setPlayerName}}
===Argumentos necessários===
* '''thePlayer:''' O [[player]] que você deseja obter o nome.

===Retorna===
Retorna uma string contendo o nome do player solicitado, ou ''false'' se o player é inválido.

===Limites===
* O nome do jogador pode consistir em caracteres ASCII entre 33 e 126 são permitidos (latim básico):
<nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~</nowiki>
* O comprimento mínimo do nome do jogador é de 1 caractere.
* O comprimento máximo do nome do jogador é de 22 caracteres.
* O nome dos jogadores não diferenciam letras maiúsculas e minúsculas. Não é possível dois clientes terem nomes iguais, mesmo com letras maiúsculas e minúsculas diferentes.

==Exemplo==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("meunome",
function(playerSource)
outputChatBox("Seu nome: "..getPlayerName(playerSource), playerSource)
end
)
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Esse exemplo envia o nome do jogador ao bate-papo.
<syntaxhighlight lang="lua">
addCommandHandler("meunome",
function()
local localPlayerName = getPlayerName(getLocalPlayer())
--e nós enviamos ao bate-papo
outputChatBox(localPlayerName)
end
)
</syntaxhighlight>
</section>

==Veja também==
{{Client player functions}}
[[es:getPlayerName]]
[[pt-br:getPlayerName]]

Multi Theft Auto: Wiki - User contributions [en]

GetPlayerName

GetPlayerName