 |
|
 PhpDig.net |
What is PhpDig?
PhpDig is a PHP MySQL based Web Spider & Search Engine. |
hw_modifyobject
Synopsis
bool hw_modifyobject(hw_link, object_id, remove_attributes, add_attributes[, recursive]);
resource hw_link: Connection
ID to Hyperwave server
int object_id: Object ID of
the object to modify
array remove_attributes:
List of attributes to remove
array add_attributes: List
of attributes to add
int recursive (optional):
Whether to modify attributes recursively; defaults
to0
Description
This function replaces the deprecated hw_changeobject() . It allows you to add or remove attributes in an object's stored object record. The attribute names are given as the element keys of the remove_attributes and add_attributes arrays, and the attribute values are given as the element values. If the value is a string, that's taken as the attribute value. If it's an array, it represents a list of attributes with the attribute name, followed by a colon, followed by the attribute value (a typical example would be the multilingual use of the Title attribute). If the value is anything other than a string or array, nothing is done to the attribute (see the following for why this is necessary).
There are some rules that must be followed, due to the way that the Hyperwave back-end works.
To add a new attribute, you must specify the attribute name in both remove_attributes and add_attributes . The entry in remove_attributes must have a value of anything other than a string or array, so that the server won't try to remove any existing attributes with the same name. The corresponding attribute name/value pair in add_attributes is added as the new attribute.
To remove an attribute, specify the name and value of the attribute you want to remove in remove_attributes , and pass NULL for add_attributes .
To modify an attribute, place the attribute (name and current value) in remove_attributes , and the same name and the new value in add_attributes .
Example
Example 513. Modify an object's attributes
/* Adding a new attribute. Running this n times will result in the same attribute
* being added n times. */
echo "Old object record: \n" . hw_getobject($hw_link, $obj_id);
$rem_array = array('Jimbo' => 0);
$add_array = array('Jimbo' => 'Test One');
hw_modifyobject($hw_link, $obj_id, $rem_array, $add_array);
echo "New object record: \n" . hw_getobject($hw_link, $obj_id);
/* Remove all attributes with the name 'Jimbo' and value 'Test One' */
echo "Old object record:\n" . hw_getobject($hw_link, $obj_id);
$rem_array = array('Jimbo' => 'Test Two');
hw_modifyobject($hw_link, $obj_id, $rem_array, NULL);
echo "New object record:\n" . hw_getobject($hw_link, $obj_id);