set_name
Description:
Sets the name of this, or gives this a guaranteed unique name (if
name
is null).
This function makes a copy of the provided name, so the caller retains ownership of the name it sent.
Parameters:
this |
a Object |
name |
new name of object |
Returns:
true if the name could be set. Since Objects that have a parent cannot be renamed, this function returns false in those cases. MT safe. This function grabs and releases this's LOCK. |