Описание

int hw_modifyobject (int connection, int object_to_change, array remove, array add, int mode)

Эта команда позволяет удалять, добавлять или модифицировать отдельные атрибуты записи объекта. Объект специфицируется ID объекта object_to_change. Первый массив remove это список атрибутов для удаления. Второй массив add это список атрибутов для добавления. Чтобы модифицировать атрибут, нужно удалить старый и добавить новый. hw_modifyobject() всегда удаляет атрибуты перед их добавлением, если только значение удаляемого атрибута не является строкой или массивом.

Последний параметр определяет, выполняется ли модификация рекурсивно. 1 обозначает рекурсивную модификацию. Если некоторые объекты не могут быть модифицированы, они игнорируются без уведомления. hw_error() не может указывать на ошибку, хотя некоторые объекты могут не быть модифицированы.

Ключами обоих массивов являются имена атрибутов. Значением каждого элемента массива может быть массив, строка или ещё что-нибудь. Если это массив, значение каждого атрибута конструируется по ключу каждого элемента плюс двоеточие и и значение каждого элемента. Если это строка, она принимается как значение атрибута. Пустая строка даёт полное удаление атрибута. Если значение не является ни массивом, ни строкой, например целым числом, с атрибутом не выполняются никакие операции вообще. Это необходимо, если вы хотите добавить совершенно новый атрибут, а непросто новое значение для существующего атрибута. Если удаляемый массив содержал пустую строку для данного атрибута, будет сделана попытка удаления этого атрибута, которая потерпит неудачу, поскольку он не существует. Последующее добавление нового значения такому атрибуту также потерпит неудачу. Установка значения для этого атрибута в, например, 0 не вызовет попытки удаления, и добавление произойдёт.

Если вы хотите изменить 'Name' атрибута с текущим значением 'books' на 'articles', вы должны будете создать жва массива и вызвать hw_modifyobject().

Пример 1. Модификация атрибута

Содержание раздела

---

---