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 | ||