SetPlayerName RU

From SA-MP Wiki

SetPlayerName

Описание:

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

Параметры:

(playerid, name[])

playerid

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

name[]

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

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

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

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

Изменение имени игрока на такое же, но с другим регистром (например, "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;
}