PT-BR/getPlayerName: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Alteração de templates para a versão em português(Shared function e OOP); Nova atribuição em links que agora redirecionam para uma página traduzida.)
 
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{BR/Funcao compartilhada}}
Esta função retorna uma string contendo o nome do jogador informado.
Esta função retorna uma string contendo o nome do jogador informado.


Line 7: Line 7:
string getPlayerName ( player thePlayer )
string getPlayerName ( player thePlayer )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[player]]:getName|name|setPlayerName}}
{{PT-BR/POO||[[player]]:getName|name|setPlayerName}}


===Argumentos obrigatórios===
===Argumentos obrigatórios===


* '''thePlayer:''' o [[player|jogador]] o qual você quer obter o nome.
* '''thePlayer:''' o [[Elemento/Player|jogador]] o qual você quer obter o nome.


===Retorno===
===Retorno===

Latest revision as of 01:10, 11 March 2020

Esta função retorna uma string contendo o nome do jogador informado.

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 obrigatórios

  • thePlayer: o jogador o qual você quer obter o nome.

Retorno

Retorna uma string contendo o nome do jogador informado, ou false caso o jogador informado seja inválido.

Limites

  • O nome do jogador deve ser composto por caracteres ASCII entre 33 e 126 (latin básico):
   !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
  • O nome deve conter pelo menos 1 caractere.
  • O nome deve conter no máximo 22 caracteres.
  • O nome dos jogadores é case-insensitive. Isso quer dizer que "Jhon" e "jhon" são a mesma coisa, embora exista a diferença de letra maiúscula e minúscula. Como não podem haver dois nomes iguais em um mesmo servidor, não pode haver um "Jhon" e um "jhon" no mesmo servidor.

Exemplo

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

Este exemplo mostra o nome do jogador local no chat.

addCommandHandler("myname",
  function()
   local localPlayerName = getPlayerName(getLocalPlayer())
   outputChatBox(localPlayerName)
  end
)

Veja também