find

The find command locates items in the design whose names match the name specification you provide. You must specify the type of item you want to find. When searching for nets and signals, the find command returns the full pathname of all nets, signals, register variables, and named events that match the name specification.

You can also use the find command to locate incrTcl classes and objects. See "incrTcl commands" in the Tcl Man Pages for more information.

Syntax

find nets | signals

[-recursive] [-in] [-out] [-inout] [-internal] [-ports] <item_name> ...

find virtuals

<item_name> ...

find classes

[<class_name>]

find objects

[-class <class_name>] [-isa <class_name>] [<object_name>]

Arguments for nets and signals

-recursive

Specifies that the scope of the search is to descend recursively into subregions. Optional. If omitted, the search is limited to the selected region.

-in

Specifies that the scope of the search is to include ports of mode IN. Optional.

-out

Specifies that the scope of the search is to include ports of mode OUT. Optional.

-inout

Specifies that the scope of the search is to include ports of mode INOUT. Optional.

-internal

Specifies that the scope of the search is to include internal items. Optional.

-ports

Specifies that the scope of the search is to include all ports. Optional. Has the same effect as specifying -in, -out, and -inout together.

<item_name> ...

Specifies the net or signal for which you want to search. Required. Multiple nets and signals and wildcard characters are allowed.

Arguments for virtuals

<item_name> ...

Specifies the virtual object for which you want to search. Required. Multiple virtuals and wildcard characters are allowed.

Arguments for classes

<class_name>

Specifies the incrTcl class for which you want to search. Optional. Wildcard characters are allowed. The options for class_name include nets, objects, signals, and virtuals. If you do not specify a class name, the command returns all classes in the current namespace context. See "incrTcl commands" in the Tcl Man Pages for more information.

Arguments for objects

-class <class_name>

Restricts the search to objects whose most-specific class is class_name. Optional.

-isa <class_name>

Restricts the search to those objects that have class_name anywhere in their heritage. Optional.

<object_name>

Specifies the incrTcl object for which you want to search. Optional. Wildcard characters are allowed. If you do not specify an object name, the command returns all objects in the current namespace context. See "incrTcl commands" in the Tcl Man Pages for more information.

Examples

find signals -r /*

Finds all signals in the entire design.

find nets -in /top/xy*

Finds all input signals in region /top that begin with the letters "xy".

Additional search options

To search for HDL items within a specific display window, use the search command or the select Edit > Find.

See also

"Wildcard characters"

Model Technology Incorporated Voice: (503) 641-1340 Fax: (503)526-5410 www.model.com sales@model.com