Deleteproperty — различия между версиями
Материал из Pro-Pawn Wiki
(Новая страница: «{{DISPLAYTITLE:deleteproperty}} {{Description | Удаляет свойство. }} {{Params|id{{=}}0, const name[]{{=}}"", value{{=}}cellmin}} {{Param | id | ID…») |
|||
Строка 22: | Строка 22: | ||
| Функция производит поиск свойства по комбинации из ID и названия (параметры <code>id</code> и <code>name</code> соответственно). Если название не указано, поиск производится по комбинации из ID и значения (параметр <code>value</code>). | | Функция производит поиск свойства по комбинации из ID и названия (параметры <code>id</code> и <code>name</code> соответственно). Если название не указано, поиск производится по комбинации из ID и значения (параметр <code>value</code>). | ||
| Все свойства хранятся в структуре типа "список". Чем больше создано свойств, тем дольше будет проходить процесс доступа к ним в среднем. | | Все свойства хранятся в структуре типа "список". Чем больше создано свойств, тем дольше будет проходить процесс доступа к ним в среднем. | ||
+ | }} | ||
+ | {{NotePawnBug | ||
+ | | {{NotePropertiesClearOnScriptUnload}} | ||
}} | }} | ||
{{Example}} | {{Example}} |
Текущая версия на 10:14, 18 июля 2018
Описание:
Удаляет свойство.
Параметры:
(id=0, const name[]="", value=cellmin) |
id | ID свойства (необязательный параметр). Может использоваться в качестве ID скрипта в хост-приложениях, поддерживающих работу сразу нескольких скриптов. |
const name[] | Название, по которому функция будет искать свойство (необязательный параметр). |
value | Значение свойства (необязательный параметр). Если название (name ) не указано, функция будет искать свойство по ID и значению.
|
Возвращаемое значение:
Значение, которое было у свойства до удаления, или
0
, если свойство не существовало.
При выгрузке/перезагрузке гейммода или фильтрскрипта удаляются все свойства, даже те, которые были созданы другими скриптами. |
Пример использования:
main()
{
// Удаление свойства с ID 0 и названием "prop1".
deleteproperty(0, "prop1");
// Удаление свойства со значением строкового типа (ID: 1, значение: 42).
deleteproperty(1, "", 42);
// Удаление свойства с получением его значения.
setproperty(0, "prop1", 42);
new value = deleteproperty(0, "prop1");
printf("Свойство prop1 было равно %d", value); // "Свойство prop1 было равно 42"
}
{
// Удаление свойства с ID 0 и названием "prop1".
deleteproperty(0, "prop1");
// Удаление свойства со значением строкового типа (ID: 1, значение: 42).
deleteproperty(1, "", 42);
// Удаление свойства с получением его значения.
setproperty(0, "prop1", 42);
new value = deleteproperty(0, "prop1");
printf("Свойство prop1 было равно %d", value); // "Свойство prop1 было равно 42"
}
См. также: