schHiReplace

schHiReplace(
[ ?replaceAll g_replaceAll ]
[ ?propName t_propName ]
[ ?condOp t_condOp ]
[ ?propValue t_propValue ]
[ ?newPropName t_newPropName ]
[ ?newPropValue t_newPropValue ]
)
=> t

Description

Replaces objects that match the specified search criteria with a specified value. Usable when editing symbols or schematics. You must have write access to each of the cellviews. Only supports matching of strings, integers, floating-point numbers, and time. This function does not support other property types.

The search criteria let you, among other tasks,

• Specify the object filter and a property name or a value expression that the objects must match
• Replace all objects at one time or view each matching item in turn and either replace the item or skip to the next item
• Search in another library or in another cellview and change a property

The schHiReplace function searches through the schematic or symbol cellview for objects that match the t_propName, t_condOp, and t_propValue arguments.

Arguments

?replaceAll g_replaceAll
	Specifies whether the replacement is done automatically or interactively. If g_replaceAll is set to t, the replacement is done automatically.
?propName t_propName	The name of the property used in the search criteria; must be enclosed in quotation marks. If t_propName is set to master, t_propValue must be t_libName t_cellName t_viewName (separated by spaces). No wildcards are supported for master property.
?condOp t_condOp	The conditional operator applied to the property name and property value for matching; must be enclosed in quotation marks. Valid Values: ==, !=, <=, >=, <, >
?propValue t_propValue	The value of the property; must be enclosed in quotation marks. The value may include wildcard expressions.
?newPropName t_newPropName
	The name of the property to replace on each of the matching objects; must be enclosed in quotation marks.
?newPropValue t_newPropValue
	The value of the new property assigned to each of the matching objects; must be enclosed in quotation marks.

Value Returned

Always returns t.

Examples

Assigns all objects with the name of I1 to I2.

schHiReplace( t "instName" "==" "I1" "instName" "I2" )

Adds a new property name newProp with value set to I2 to all objects with the name I1.

schHiReplace( t "instName" "==" "I1" "newProp" "I2" )

Return to top