GetPlayerName: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{BR/Função compartilhada}}
This function returns a string containing the name of the specified player.
Essa função retorna uma string contendo o nome do player especificado.


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


===Returns===
===Retorna===
Returns a string containing the requested player's name, or ''false'' if the player passed to the function is invalid.
Retorna uma string contendo o nome do player solicitado, ou ''false'' se o player é inválido.


===Limits===
===Limites===
* Player name can consist of ASCII characters between 33 and 126 are allowed (basic latin):   
* O nome do jogador pode consistir em caracteres ASCII entre 33 e 126 são permitidos (latim básico):   
     <nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~</nowiki>
     <nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~</nowiki>
* Minimal player name length is 1 character.  
* O comprimento mínimo do nome do jogador é de 1 caractere.  
* Maximum player name length is 22 characters.
* O comprimento máximo do nome do jogador é de 22 caracteres.  
* Player names are case-insensitive. It is not possible to have two clients with same name but different character case.
* 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.


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


<section name="Client" class="client" show="true">
<section name="Client" class="client" show="true">
This example outputs the local player name to the chatbox.
Esse exemplo envia o nome do jogador ao bate-papo.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addCommandHandler("myname",
addCommandHandler("meunome",
   function()
   function()
   local localPlayerName = getPlayerName(getLocalPlayer())
   local localPlayerName = getPlayerName(getLocalPlayer())
   --and we output it to the chatbox
   --e nós enviamos ao bate-papo
   outputChatBox(localPlayerName)
   outputChatBox(localPlayerName)
   end
   end
Line 45: Line 45:
</section>
</section>


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

Revision as of 14:39, 20 April 2022

Essa função retorna uma string contendo o nome do player especificado.

Sintaxe

string getPlayerName ( player thePlayer )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: player:getName(...)
Variável: .name
Oposto: 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):
   !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
  • 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

Click to collapse [-]
Server
addCommandHandler("meunome",
  function(playerSource)
    outputChatBox("Seu nome: "..getPlayerName(playerSource), playerSource)
  end
)
Click to collapse [-]
Client

Esse exemplo envia o nome do jogador ao bate-papo.

addCommandHandler("meunome",
  function()
   local localPlayerName = getPlayerName(getLocalPlayer())
   --e nós enviamos ao bate-papo
   outputChatBox(localPlayerName)
  end
)

Veja também