Querying Objects - 2023.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
UG835
Release Date
2023-05-16
Version
2023.1 English
All first class objects can be queried by a get_* Tcl command that generally has the following syntax:
  • get_<object_type> <pattern>
Where pattern is a search <pattern>, which includes if applicable a hierarchy separator to get a fully qualified name. Objects are generally queried by a string pattern match applied at each level of the hierarchy, and the search pattern also supports wildcard style search patterns to make it easier to find objects, for example:
  • get_cells */inst_1
This command searches for a cell named inst_1 within the first level of hierarchy under the top-level of hierarchy. To recursively search for a pattern at every level of hierarchy, use the following syntax:
  • get_cells -hierarchical inst_1
This command searches every level of hierarchy for any instances that match inst_1.
For complete coverage of the command syntax, see the specific online help for the individual command:
  • help get_cells
  • get_cells -help