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 find classes 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
Model Technology Incorporated Voice: (503) 641-1340 Fax: (503)526-5410 www.model.com sales@model.com |