dni::get_cells (::quartus::dcmd_dni)

The following table displays information for the dni::get_cells Tcl command:

Tcl Package and Version

Belongs to ::quartus::dcmd_dni 1.0

Syntax dni::get_cells [-h | -help] [-long_help] [-exact] [-filter <expression> ] [-hierarchical] [-nocase] [-of_objects <objects> ] [-quiet] [ <patterns> ]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-exact exact patterns to search for object. Exact patterns cannot include wildcard characters "*" or "?" and escaped characters "\".
-filter <expression> filter search by expression
-hierarchical search level-by-level down from current instance
-nocase perform case insensitive search
-of_objects <objects> search based on relationship to objects
-quiet Suppress error, warning, or information messages
<patterns> patterns to search for object. Patterns can include wildcard characters "*" or "?". Wildcard characters do not match with hierarchy separator
Description
This command creates a collection of instances from the current
design, relative to the current instance.
Example Usage
# Suppose a design from top contains two hierchical instances. 
#   instance name (module name)
# |             (top) 
# |-h1_i1        (mod_A)
# | |-h2_i1       (mod_B)
# | 
# |-h1_i2        (mod_A)
#   |-h2_i1       (mod_B)

# Get instances from top module: {h1_1 h1_2}
dni::get_cells

# Get hierarchical instances with prefix h from top module: { h1_i1 h1_i1|h2_i1 h1_i2 h1_i2|h2_i1 }
dni::get_cells h* -hierarchical

# Get hierarchical instances with prefix h from |h1_i2 instance: { h1_i2|h2_i1 }
dni::current_instance h1_i2
dni::get_cells h* -hierarchical

# Get instance of instance port
dni::get_cells -of_objects [dni::get_pins h1_i2|in1]
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful