dbReplaceProp

dbReplaceProp( 
g_object 
t_name 
t_propType 
g_value 
) 
=> d_prop / nil 

Description

Replaces a scalar property for an object. Calls to dbReplaceProp for abutment groups must be made before calls to dbReplaceProp for pcell properties.

This function is similar to dbCreateProp, except that if a property named t_name already exists on the specified object, its type and value are replaced by the ones specified in t_propType and g_value.

Arguments

g_object	The database object which can be a dbId, ddId, or dbBagId.
t_name	Name of the property. If t_name exists and is a range or enumerated property, it is replaced by a scalar property.
t_propType	Type of the property.
g_value	Value of the property; must be consistent with t_propType.

Value Returned

d_prop	A scalar property belonging to the database object.
nil	Any argument is in error, or d_object is not a hierarchical property.

Examples

dbReplaceProp(dbId "netNumber" "int" 12)

dbReplaceProp(dbId "drawGrid?" "boolean" t)

Related Topics

Property Creation and Modification Functions

Return to top