opcCreateExpression

opcCreateExpression( 
?dataSource s_dataSource
?dataType t_dataType
[ ?conditions l_conditions ]
)
=> nil / list

Description

Defines an expression to be used in Navigator custom queries.

Arguments

`?dataSource` s_dataSource
	Design object to be used in the expression, for example, `Instances`, `Nets`, `Pins`.
`?dataType` t_dataType
	Design object type. Only required for user-specified data. Example: `instance`, `net`, `pin`.
`?conditions` l_conditions
	List of conditions that must be met for the objects in the data source to be accepted as valid by the expression. The conditions are combined using logical AND. Conditions are created using `opcCreateCondition`.

Value Returned

A SKILL list containing the data source and optionally the data type and list of conditions as elements.

Examples

Define an expression that can be used to retrieve iterated instances that are of size 2 and their name contains X.

expression = opcCreateExpression(?dataSource 'Instances ?conditions
list(opcCreateCondition(?attrName 'Bits ?opName "=" ?value "2") opcCreateCondition(?attrName 'Name ?opName "Contains" ?value "X")))

The returned value is ("Instances" "instance" (("Bits" "=" "2") ("Name" "Contains" "X"))) and can be used in defining queries.

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