Product Documentation
Virtuoso Schematic Editor SKILL Functions Reference
Product Version IC23.1, November 2023

schHiFind

schHiFind(
[ ?propName t_propName ]
[ ?condOp t_condOp ]
[ ?propValue t_propValue ]
)
=> t

Description

Finds objects that match specified search criteria in a schematic or symbol view. You can specify the object filter as well as a property name or value expression that matches the objects. Usable when editing schematics or symbols. Matching is supported only for strings, integers, floating-point numbers, and time. Other property types are not supported.

The schHiFind function searches through the schematic or symbol cellview for objects that match the t_propName, t_condOp, and t_propValue arguments. It highlights the first object that matches the search criteria and opens the Schematic Find form.

If t_propName is master, t_propValue must be libName cellName viewName (separated by spaces). Wildcards are not supported for the master property.

See also the schVerboseFind environment variable which can be used to control the messages output in the CIW and CDS.log file when find criteria has not been met.

Arguments

?propName t_propName

The property name used in the search criteria; must be enclosed in quotation marks.

?condOp t_condOp

The conditional operator that is 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.

Value Returned

Always returns t.

Examples

Displays the options form with t_propName set to name, t_condOp set to ==, and t_propValue set to I1. All objects that have name set to I1 are added to the list. The first one is highlighted on the screen.

schHiFind( "name" "==" "I1" )

Related Topics

schVerboseFind


Return to top
 ⠀
X