SAMP/DeletePVar
Материал из Wikipedia Pi
DeletePVar
Добавлено |
Функция работает только начиная с версии SA-MP 0.3z и не будет работать в предыдущих версиях! |
Описание:
Удаляет (обнуляет) ранее установленную персональную переменную.
Параметры:
(playerid, varname[])
playerid | ID игрока, чью персональную переменную нужно удалить. |
varname | Название персональной переменной, которую нужно удалить. |
Важное |
После удаления персональной переменной, запрос её значения будет возвращать 0 для целых чисел, а также чисел с плавающей точкой, и NULL для строковых. Персональный переменные создаются только в момент установки их значения функциями SetPVarInt, SetPVarFloat, SetPVarString и удаляются автоматически при отключении игрока (после вызова OnPlayerDisconnect). |
Возвращаемые значения:
- 1: функция успешно выполнена.*
- 0: функция не выполнена (указанный игрок не подключен или неверное имя переменной).
Пример использования:
SetPVarInt(playerid, "SomeVarName", 69);
// Там, где нужно удалить переменную
DeletePVar(playerid, "SomeVarName");
Связанные функции
Следующие функции также могут быть полезны, поскольку они так или иначе связаны с рассматриваемой функцией.
- GetPVarInt - Получает значение персональной переменной с целочисленным значением.
- GetPVarFloat - Получает значение персональной переменной с плавающей точкой.
- GetPVarNameAtIndex - Получает индекс (порядковый номер) персональной переменной по её имени.
- GetPVarString - Получает значение строковой персональной переменной.
- GetPVarsUpperIndex - Получает индекс (порядковый номер) следующей создаваемой персональной переменной.
- GetPVarType - Получает тип персональной переменной по её имени.
- SetPVarInt - Устанавливает значение персональной переменной с целочисленным значением.
- SetPVarFloat - Устанавливает значение персональной переменной с плавающей точкой.
- SetPVarString - Устанавливает значение строковой персональной переменной.