SAMP/DeletePVar

Материал из Wiki.Pawno-Info.Ru
Перейти к навигации Перейти к поиску

DeletePVar


Wiki added.png

Добавлено

Функция работает только начиная с версии SA-MP 0.3z и не будет работать в предыдущих версиях!


Описание:

Удаляет (обнуляет) ранее установленную персональную переменную.


Параметры:

(playerid, varname[])


playeridID игрока, чью персональную переменную нужно удалить.
varnameНазвание персональной переменной, которую нужно удалить.


Wiki note important.png

Важное
примечание

После удаления персональной переменной, запрос её значения будет возвращать 0 для целых чисел, а также чисел с плавающей точкой, и NULL для строковых.
Персональный переменные создаются только в момент установки их значения функциями SetPVarInt, SetPVarFloat, SetPVarString и удаляются автоматически при отключении игрока (после вызова OnPlayerDisconnect).


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

  • 1: функция успешно выполнена.*
  • 0: функция не выполнена (указанный игрок не подключен или неверное имя переменной).


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

SetPVarInt(playerid, "SomeVarName", 69);
// Там, где нужно удалить переменную
DeletePVar(playerid, "SomeVarName");


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

Следующие функции также могут быть полезны, поскольку они так или иначе связаны с рассматриваемой функцией.
  • GetPVarInt - Получает значение персональной переменной с целочисленным значением.
  • GetPVarFloat - Получает значение персональной переменной с плавающей точкой.
  • GetPVarNameAtIndex - Получает индекс (порядковый номер) персональной переменной по её имени.
  • GetPVarString - Получает значение строковой персональной переменной.
  • GetPVarsUpperIndex - Получает индекс (порядковый номер) следующей создаваемой персональной переменной.
  • GetPVarType - Получает тип персональной переменной по её имени.
  • SetPVarInt - Устанавливает значение персональной переменной с целочисленным значением.
  • SetPVarFloat - Устанавливает значение персональной переменной с плавающей точкой.
  • SetPVarString - Устанавливает значение строковой персональной переменной.