Функции других заголовочных файлов Pawn
From SA-MP Wiki
Contents |
Функции ядра (core.inc)
random
Description:
Получает псевдослучайное число, которое будет числом различных комбинаций, начиная с 0 и кончая числом, меньшим числа.
Parameters:({{{1}}})
| max | Максимальное число для случайной последовательности. |
Возвращаемые значения:
Случайное число между 0 и max.
new iRandomNumber = random(25); // случайное число между 0 и 24
sizeof
Description:
Возвращает предопределенный размер переменной.
Parameters:({{{1}}})
| variable[] | Переменная, размер которой вы хотите знать. |
Возвращаемые значения:
Размер перменной в виде числа ячеек.
new string[256]; new length = sizeof(string); // length = 256
Функции серверного окна
clreol
Description:
Эта функция очищает текущую строку вывода вплоть до ее конца, может быть полезна в Windows-сервере.
 Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
Возвращаемые значения:
Всегда 0.
clreol();
clrscr
Description:
Эта функция очищает весь вывод, который виден на экране.
Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
Возвращаемые значения:
Всегда 0.
clrscr();
getarg
Важное | НЕ работает с массивами в качестве параметра ! |
Description:
Получает указанный аргумент из функции, очень удобно использовать с функциями, которые имеют динамическое число аргументов.
Parameters:({{{1}}})
| arg | ID агргумента, значение которого вы хотите получить. |
| index=0 | Ячейка, с которой надо читать, если аргумент - строка. |
Возвращаемые значения:
Одна ячейка.
getarg(0);
getchar
Description:
Эта функция позволяет Вам прочитать один символ, введенный в консольном окне.
Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
| echo=0 | Хотите ли Вы вывести введенный символ в консольном окне ? |
Возвращаемые значения:
Одна ячейка с введенным символом.
new char[1] = getchar(1);
getstring
Description:
Эта функция считывает строку с клавиатуры. Вы можете определить число ячеек, которое необходимо прочитать (не символов!), вторым параметром.
Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
| string[] | СТрока, в которую запишется ввод. |
| size=sizeof(string) | Число ячеек, которое необходимо прочитать с клавиатуры. |
| pack=false | Хотите ли вы запаковать строку ? |
getstring(string, 256, false);
getvalue
Description:
Эта функция позволяет вам считать знаковое значение с клавиатуры и числовой корень степени от 2 до 36.
Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
| base=10 | Степень корня по умолчанию. |
| end='\r' | Параметр для остановки считывания значения. |
Возвращаемые значения:
Запрошенное значение.
new value = getvalue(10, '\r');
gotoxy
Description:
ВЫ можете использовать gotoxy() для уставноки текущего положения курсора в консольном окне. Верхний левый угол имеет координаты 1,1.
Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
| x=1 | X-позиция курсора в консольном окне. |
| y=1 | Y-позиция курсора в консольном окне. |
gotoxy(20,43);
heapspace
Description:
Heapspace позволяет Вам освободить место в куче, общей области памяти.
Parameters:({{{1}}})
Возвращаемые значения:
Количество байтов для сохранения.
new sparedBytes = heapspace();
numargs
Description:
Эта функция возвращает число аргументов, переданных в функцию с динамическим числом аргументов.
Parameters:({{{1}}})
Возвращаемые значения:
Число переданных аргументов.
new argumentCount = numargs();
Description:
Выводит неформатированнную строку в консоли.
Parameters:({{{1}}})
| const string[] | Строку, которую вы хотите отобразить. |
print("This is an example output.");
printf
Description:
Printf выводит форматированную строку в консоль с указанными опциями форматирования.
Parameters:({{{1}}})
| const format[] | Формат, в котором Вы хотите вывести предложение. |
| %b представлет число в двоичном корне. |
| %c представлет символ. |
| %d представлет двойное (или нормальное) целое число. |
| %f представлет вещественно число. |
| %i представлет целое число. |
| %s представлет строку. |
| %x представлет число в шестнадцатиричном формате. |
printf("This %s has %d words.", "string", 4);
setarg
Description:
Изменяет значение данного аргумента.
Parameters:({{{1}}})
| arg | ID аргумента, значение которого вы хотите изменить. |
| index=0 | Ячейка аргумента. |
| value | Новое значение |
setarg(0, 3, "e");
wherexy
Description:
WhereXY позволяет Вам получить текущую позицию курсора в консольном окне.
Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
| &x | Переданная по ссылке переменная, в которую запишется x-позиция. |
| &y | Переданная по ссылке переменная, в которую запишется y-позиция. |
Возвращаемые значения:
Всегда 0.
wherexy(x,y);
Свойства
deleteproperty
Description:
Эта функция позволяет Вам удалить ранее установленное свойство.
Parameters:({{{1}}})
| id=0 | Определяет, какую виртуальную машину использовать. |
| const name[]="" | Определяет, использовать ли вызов по имени, Вам следует указать здесь "". |
| value=cellmin | Это идентифицирует переменную. Используйте хэш-функцию для вычисления ее из строки. |
deleteproperty(0, "", 123984334);
existproperty
Description:
Вы можете использовать эту функцию для проверки, существует ли указанное свойство. Вы можете использовать функцию Adler 32 для генерации хеша.
Parameters:({{{1}}})
| id=0 | Используемая виртуальная машина, Вам следует указать здесь ноль. |
| const name[]="" | Использовать свойство через его имя, Вам следует указать здесь "". |
| value=cellmin | Хэш свойства, возможно сгенерированный функцией Adler 32. |
if(existproperty(0, "", 9384932)){
getproperty
Description:
Получает указанное свойство из памяти, возвращаемоая строка вернется как пакованная !
Parameters:({{{1}}})
| id=0 | Используемая виртуальная машина, Вам следует указать здесь ноль. |
| const name[]="" | Имя свойства, Вам следует указать здесь "". |
| value=cellmin | Хэш свойства, может быть сгенерирован через Adler 32. |
| &string[]="" | Переданная по ссылке переменная, в которую запишется результат. |
getproperty(0, "", 93473413, value);
setproperty
Description:
Используйте эту функцию для сохранения значение в свойство.
Parameters:({{{1}}})
| id=0 | Используемая виртуальная машина, Вам следует указать здесь ноль. |
| const name[]="" | Имя свойства, Вам следует указать здесь "". |
| value=cellmin | Хэш свойства, может быть сгенерирован через Adler 32. |
| const string[]="" | Действительно значение свойства, будет запаковываться, когда используется. |
setproperty(0, "", 9723423, value);
Функции UDP-широковещания
listenport
Description:
Эта функция позволяет Вам выбрать порт, который будет слушать ваш pawn-скрипт.
Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
| port | Порт. |
listenport(7778);
sendpacket
Description:
Эта функция позволяет Вам псолать пакет через интернет или на вашу локальную машину.
Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
| const packet[] | Отправляемый пакет, строка. |
| size | Размер запакованного пакета, например, sizeof(packet). |
| const destination[]="" | Адрес назначения, в формате 0.0.0.0:0000. Пакет вещается на всю сеть, если слева пусто. |
sendpacket("Hello world!", 12);
sendstring
Description:
Посылает строку в определенное место, или вещает ее по всей сети.
Предупреждение! | Эта функция не работает в текущей версии SA:MP! |
({{{1}}})
| const message[] | Строка, которую вы хотите отправить. |
| const destination[]="" | Адрес назначения, в формате 0.0.0.0:0000. Пакет вещается на всю сеть, если слева пусто. |
sendstring("Hello world!", "127.0.0.1:7779");
