set_name


Description:

public bool set_name (string? name)

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.