[Tutorial] Обработка команд в OnPlayerCommandText.
#1

Хочу поделиться с вами одним из способов обработки команд, введенных игроком (OnPlayerCommandText).
Так как в программировании важна декомпозиция, то логично было бы описывать обработку различных команд в разных файлах исходного кода (команды /buyhouse /setrent в файле описывающем систему домов, команды /ban /kick в отдельном файле с админскими командами и тд), и сейчас я покажу один из способов это реализовать.
Для начала создаем файл command.inc, в нем у нас будет описан паблик OnPlayerCommandText.
Идея заключается в том, чтобы для каждой команды создать свою функцию, а в OnPlayerCommandText определять какая функция соответствует введенной команде и вызывать ее, передав ей массив введенных параметров.
С начала напишем саму функцию, которая будет превращать строку в двумерный массив параметров, первым из которых (под номером 0) будет название самой функции, зачем увидите дальше. Вот собственно ее код:
pawn Code:
cmdtext2params(const cmdtext[], params[][], size1 = sizeof params, size2 = sizeof params[])
{
    new currentparam;
    new n;
    new c = 1// пропускаем слэш
    while(cmdtext[c])
    {
        if(cmdtext[c] != ' ') {
            if(currentparam >= size1) break;
            if(n < size2-1)  params[currentparam][n++] = cmdtext[c];
        }
        else if(cmdtext[c+1] && cmdtext[c+1] != ' ') {
            currentparam++;
            n=0;
        }
        c++;
    }
    #if defined DEBUG
    for(n=0;n<min(currentparam+1,size1);n++)
        printf("cmd param %d: %s", n, params[n]);
    #endif
}
Теперь нам потребуется написать несколько макросов, облегчающих добавление новой команды.
pawn Code:
#define cmd(%1) if(strcmp(#%1,params[0],true)==0){cmd_%1(playerid);return(1);}
#define cmdf(%1) if(strcmp(#%1,params[0],true)==0){cmdf_%1(playerid,params);return(1);}

#define altername(%1,%2) if(strcmp(#%2,params[0],true)==0){cmd_%1(playerid);return(1);}
#define alternamef(%1,%2) if(strcmp(#%2,params[0],true)==0){cmdf_%1(playerid,params);return(1);}
Первый макрос создан для команд без параметров, второй для команд с параметрами, третий и четвертый позволяют задавать альтернативные имена для команд.
В конце файла на всякий случай убираем макросы.
pawn Code:
#undef cmd
#undef cmdf

#undef altername
#undef alternamef
Теперь наконец опишем саму функцию OnPlayerCommandText
pawn Code:
public OnPlayerCommandText(playerid, cmdtext[])
{
    new params[7][20]// массив параметров
    cmdtext2params(cmdtext, params);    // выдираем параметры из строки
    if(!params[0][0]) return 0; // если нулевой параметр(имя команды) не заданно, то делать нам тут нечего - возвращаем ноль
    // теперь собственно список самих команд:
    cmd(kill)
    altername(kill,умри)    // задаем альтернативное имя для команды kill
    cmdf(givemoney)
    alternamef(givemoney,gm)
    return 0;
}
В ней перечислены две команды - одна с параметрами, другая без. И альтернативные имена для каждой из них.
Наш макрос преобразует каждую из этих строчек в сравнение значения в скобках с введенной командой из params[0] и в случае совпадения вызовет функцию с именем cmdf_имякоманды и параметрами playerid и params. Обратите внимание, что в местах использования макроса мы не ставим точку с запятой, а между параметрами altername не ставим лишних пробелов. Создать русскоязычную команду можно только через altername/alternamef.
Теперь в отдельном файле опишем функции соответствующие нашим командам.
pawn Code:
cmd_kill(playerid)
{
    SetPlayerHealth(playerid, 0);
}

cmdf_givemoney(playerid, params[][])
{
    if(!IsPlayerAdmin(playerid))
    {
        SendClientMessage(playerid, COLOR_RED, "У вас нет прав на использование этой команды.");
        return 1;
    }
    if(!params[1][0] || !params[2][0])
    {   // удобная проверка на все необходимые параметры в одном месте.
        new string[MAX_STRING];
        /* за счет передачи имени введенной команды в params[0] - хелп будет универсален для различных имен команды */
        format(string, sizeof string, "ИСПОЛЬЗОВАНИЕ: /%s [playerid] [money]", params[0]);
        SendClientMessage(playerid, COLOR_HELP, string);
        return 1;
    }
    new player = strval(params[1]);
    if(!IsPlayerConnected(player))
    {
        SendClientMessage(playerid, COLOR_RED, "Нет такого игрока.");
        return 1;
    }
    new money = strval(params[2]);
    GivePlayerMoney(player, money);
    return 1;
}
Так как параметры уже разделены, мы можем легко проверить какой из них задан а какой нет (params[][0] не равен нулю).
А так как у нас для одной функции существует несколько имен и чтобы для /gm не выдавался хелп с описанием /givemoney мы форматируем строчку используя введенную игроком команду (передается в params[0]).
В функцию cmd_kill никаких параметров не передается, так как они там не нужны.

command.inc - http://pastebin.com/7c8Y9FJY
new.pwn - http://pastebin.com/STsZMusG
Reply


Messages In This Thread

Forum Jump:


Users browsing this thread: 1 Guest(s)