SetPlayerName RU

From SA-MP Wiki

Jump to: navigation, search

SetPlayerName

Описание:

Устанавливает имя игроку.


Параметры:
(playerid, name[])
playeridID игрока, которому устанавливается имя.
name[]Устанавливаемое имя. Может быть длиной в 3-24 символов и содержать только верные символы (0-9, a-z, A-Z, [], (), $ @ . _ и =).


Возвращаемые значения:

  • 1, если имя было изменено.
  • 0, если игрок уже использует это имя.
  • -1, если имя не может быть изменено (занято, слишком длинное или содержит недопустимые символы).


Image:32px-Circle-style-warning.png

Важные
Примечания

  • Изменение имени игрока на такое же, но с другим регистром (например, "John" на "JOHN") не работает.
  • При использовании в OnPlayerConnect, новое имя не будет отображено для подключившегося игрока.
  • Указание пустой строки в качестве нового имени рушит сервер.
  • Имена игроков могут содержать до 24 символов при использовании этой функции, однако при подключении к серверу с браузера серверов SA-MP, имена игроков не могут содержать более 20 символов (сервер не допустит вход). Это позволяет использовать 4 дополнительных символа с функцией SetPlayerName.


Пример использования:

// Команда просто устанавливает имя игрока на "Superman", если возможно, без проверок и сообщений.
if(strcmp(cmdtext, "/superman", true) == 0)
{
    SetPlayerName(playerid, "Superman");
    return 1;
}
 
// Команда устанавливает имя игрока на "Superman", если возможно. 
// Информирует игрока об ошибках при помощи оператора "switch".
if(strcmp(cmdtext, "/superman", true) == 0)
{
    switch(SetPlayerName(playerid, "Superman"))
    {
        case -1: SendClientMessage(playerid, 0xFF0000FF, "Невозможно изменить ваше имя, кто-то уже известен как 'Superman'.");
        case 0: SendClientMessage(playerid, 0xFF0000FF, "Вы уже 'Superman'");
        case 1: SendClientMessage(playerid, 0x00FF00FF, "Теперь вы известны как 'Superman'");
    }
    return 1;
}

Связанные функции

Следующие функции могут быть полезны, т.к. они так или иначе связаны с текущей функцией.

Personal tools
In other languages