GetPlayerName: Difference between revisions

Latest revision as of 22:01, 15 January 2024

This function returns a string containing the name of the specified player.

Syntax

string getPlayerName ( player thePlayer )

OOP Syntax Help! I don't understand this!

Method: player:getName(...)

Variable: .name

Counterpart: 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):

!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~

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

Click to collapse [-]

Server

addCommandHandler("myname", function(ply)
    outputChatBox("Your name: "..getPlayerName(ply), ply)
end)

Click to collapse [-]

Client

This example outputs the local player name to the chatbox.

addCommandHandler("myname", function()
    -- output local player's name to the chatbox
    outputChatBox(getPlayerName(localPlayer))
end)

@@ Line 1: / Line 1: @@
 __NOTOC__
-{{BR/Função compartilhada}}
+{{Server client function}}
-Essa função retorna uma string contendo o nome do player especificado.
+This function returns a string containing the name of the specified player.
-==Sintaxe==
+==Syntax==
 <syntaxhighlight lang="lua">
 string getPlayerName ( player thePlayer )
 </syntaxhighlight>
-{{PT-BR/POO||[[player]]:getName|name|setPlayerName}}
+{{OOP||[[player]]:getName|name|setPlayerName}}
-===Argumentos necessários===
+===Required Arguments===
-* '''thePlayer:''' O [[player]] que você deseja obter o nome.
+* '''thePlayer:''' the [[player]] you want to get the name of
-===Retorna===
+===Returns===
-Retorna uma string contendo o nome do player solicitado, ou ''false'' se o player é inválido.
+Returns a string containing the requested player's name, or ''false'' if the player passed to the function is invalid.
-===Limites===
+===Limits===
-* O nome do jogador pode consistir em caracteres ASCII entre 33 e 126 são permitidos (latim básico):
+* Player name can consist of ASCII characters between 33 and 126 are allowed (basic latin):
-    <nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~</nowiki>
+ <nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~</nowiki>
-* O comprimento mínimo do nome do jogador é de 1 caractere.
+* Minimal player name length is 1 character.
-* O comprimento máximo do nome do jogador é de 22 caracteres.
+* Maximum player name length is 22 characters.
-* 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.
+* Player names are case-insensitive. It is not possible to have two clients with same name but different character case.
-==Exemplo==
+==Example==
 <section name="Server" class="server" show="true">
 <syntaxhighlight lang="lua">
-addCommandHandler("meunome",
+addCommandHandler("myname", function(ply)
-  function(playerSource)
+     outputChatBox("Your name: "..getPlayerName(ply), ply)
-     outputChatBox("Seu nome: "..getPlayerName(playerSource), playerSource)
+end)
-  end
-)
 </syntaxhighlight>
 </section>
 <section name="Client" class="client" show="true">
-Esse exemplo envia o nome do jogador ao bate-papo.
+This example outputs the local player name to the chatbox.
 <syntaxhighlight lang="lua">
-addCommandHandler("meunome",
+addCommandHandler("myname", function()
-  function()
+    -- output local player's name to the chatbox
-   local localPlayerName = getPlayerName(getLocalPlayer())
+    outputChatBox(getPlayerName(localPlayer))
-   --e nós enviamos ao bate-papo
+end)
-   outputChatBox(localPlayerName)
-  end
-)
 </syntaxhighlight>
 </section>
-==Veja também==
+==See Also==
 {{Client player functions}}
 [[es:getPlayerName]]
 [[pt-br:getPlayerName]]