dbReplaceHierProp

dbReplaceHierProp( 
g_object 
t_name 
) 
=> d_prop / nil 

Description

Replaces a hierarchical property for an object.

This function is similar to dbCreateHierProp except that if a property named t_name already exists on the specified object, its value is deleted as are the properties associated with it if it is a hierarchical property. A hierarchical property can be defined to have other properties associated with it.

Arguments

g_object	The database object which can be a dbId, ddId, or dbBagId.
t_name	Name of the property.

Value Returned

d_prop	A hierarchical property belonging to the database object.
nil	d_object is not valid or t_name is not a string.

Examples

dbReplaceHierProp(inst "prop1")

Related Topics

Property Creation and Modification Functions

Return to top