|
PHP5中文手册
hw_Modifyobject(PHP 4) hw_Modifyobject — Modifies object record Description
bool hw_modifyobject
( int $connection
, int $object_to_change
, array $remove
, array $add
[, int $mode
] )
This command allows to remove, add, or modify individual attributes of an object record. The object is specified by the Object ID object_to_change . The first array remove is a list of attributes to remove. The second array add is a list of attributes to add. In order to modify an attribute one will have to remove the old one and add a new one. hw_modifyobject() will always remove the attributes before it adds attributes unless the value of the attribute to remove is not a string or array. The last parameter determines if the modification is performed recursively. 1 means recursive modification. If some of the objects cannot be modified they will be skipped without notice. hw_error() may not indicate an error though some of the objects could not be modified. The keys of both arrays are the attributes name. The value of each array element can either be an array, a string or anything else. If it is an array each attribute value is constructed by the key of each element plus a colon and the value of each element. If it is a string it is taken as the attribute value. An empty string will result in a complete removal of that attribute. If the value is neither a string nor an array but something else, e.g. an integer, no operation at all will be performed on the attribute. This is necessary if you want to add a completely new attribute not just a new value for an existing attribute. If the remove array contained an empty string for that attribute, the attribute would be tried to be removed which would fail since it doesn't exist. The following addition of a new value for that attribute would also fail. Setting the value for that attribute to e.g. 0 would not even try to remove it and the addition will work. If you would like to change the attribute 'Name' with the current value 'books' into 'articles' you will have to create two arrays and call hw_modifyobject(). Example#1 modifying an attribute
<?php Example#2 adding a completely new attribute
<?php
Example#3 modifying Title attribute
<?php Example#4 modifying Title attribute
<?php Example#5 removing attribute
<?php
如果成功则返回 TRUE,失败则返回 FALSE。 |