RU/getPlayerName: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{RU/Server client function}}
Функция возвращает строку, содержащую имя указанного игрока.
Эта функция возвращает строку, содержащую имя указанного игрока.


==Синтаксис==
==Синтаксис==
Line 7: Line 7:
string getPlayerName ( player thePlayer )
string getPlayerName ( player thePlayer )
</syntaxhighlight>
</syntaxhighlight>
{{RU/OOP||[[player]]:getName|name|setPlayerName}}
===Обязательные аргументы===
* '''thePlayer:''' [[игрок]], имя которого вы хотите получить.


===Обязательные параметры===
===Возвращает===
* '''thePlayer:''' Игрок, имя которого необходимо получить.
* [[строка|Строку]], содержащую имя указанного игрока.
* ''false'', если элемент игрока, переданный в функцию, недействителен.


===Возвращаемое значение===
===Ограничения===
Возвращает строку, содержащую имя указанного игрока, или ''false'', если параметр (игрок), переданный в функцию - неверный.
* Допускаются только символы ASCII между 33 и 126 (базовая латиница): 
    <nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~</nowiki>
* Минимальная длина имени игрока - 1 символ.
* Максимальная длина имени игрока - 22 символа.
* Имена игроков чувствительны к регистру. Невозможно, чтобы два клиента с одинаковым именем, но с разным регистром, были подключены к одному серверу.


==Пример==
==Пример==
<section name="Server" class="server" show="true">
<section name="Сервер" class="server" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addCommandHandler("myname",
addCommandHandler("myname",
   function(playerSource)
   function(playerSource)
     outputChatBox("Your name: "..getPlayerName(playerSource), playerSource)
     outputChatBox("Ваше имя: "..getPlayerName(playerSource), playerSource)
   end
   end
)
)
Line 25: Line 33:
</section>
</section>


<section name="Client" class="client" show="true">
<section name="Клиент" class="client" show="true">
This example outputs the local player name to the chatbox.
Данный пример выводит имя локального игрока в чат.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addCommandHandler("myname",
addCommandHandler("myname",
   function()
   function()
   local localPlayerName = getPlayerName(getLocalPlayer())
   local localPlayerName = getPlayerName(getLocalPlayer())
  --and we output it to the chatbox
   outputChatBox(localPlayerName)
   outputChatBox(localPlayerName)
   end
   end
Line 39: Line 46:


==Смотрите также==
==Смотрите также==
{{RU/Player functions}}
{{RU/Client player functions}}
 
[[en:getPlayerName]]
[[en:getPlayerName]]

Latest revision as of 16:00, 17 October 2014

Эта функция возвращает строку, содержащую имя указанного игрока.

Синтаксис

string getPlayerName ( player thePlayer )

Синтаксис ООП Помогите! Я не понимаю, что это!

Метод: player:getName(...)
Переменная: .name
Парная функция: setPlayerName

Обязательные аргументы

  • thePlayer: игрок, имя которого вы хотите получить.

Возвращает

  • Строку, содержащую имя указанного игрока.
  • false, если элемент игрока, переданный в функцию, недействителен.

Ограничения

  • Допускаются только символы ASCII между 33 и 126 (базовая латиница):
   !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
  • Минимальная длина имени игрока - 1 символ.
  • Максимальная длина имени игрока - 22 символа.
  • Имена игроков чувствительны к регистру. Невозможно, чтобы два клиента с одинаковым именем, но с разным регистром, были подключены к одному серверу.

Пример

Click to collapse [-]
Сервер
addCommandHandler("myname",
  function(playerSource)
    outputChatBox("Ваше имя: "..getPlayerName(playerSource), playerSource)
  end
)
Click to collapse [-]
Клиент

Данный пример выводит имя локального игрока в чат.

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

Смотрите также