Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 9/26/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

4.1.34.9. get_partitions (::quartus::sdc_ext)

The following table displays information for the get_partitions Tcl command:

Tcl Package and Version

Belongs to ::quartus::sdc_ext

Syntax get_partitions [-h | -help] [-long_help] [-cell] [-hierarchical] [-nocase] [ <filter> ]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-cell Returns a cell collection inside the partitions matching the <filter>
-hierarchical Specifies if hierarchical searching method should be used
-nocase Specifies the matching of node names to be case-insensitive
<filter> Valid partitions (string patterns are matched using Tcl string matching)
Description
Returns a collection of partitions matching the filter
by default. All partition names in the collection
match the specified pattern.  Wildcards can be used to
select multiple partitions at once.

The -cell option creates and returns the collection of
cells found inside the partitions matching the
<filter> instead of returning a partition collection.

There are three Tcl string matching schemes available
with this command: default, -hierarchical, and
-no_case.

When using the default matching scheme, pipe
characters separate one hierarchy level from the
next. They are treated as special characters and are
taken into account when string matching with wildcards
is performed. The default matching scheme does not
force the search to proceed recursively down the
hierarchy.

Using the hierarchical matching scheme forces the
search to proceed recursively down the hierarchy.

The -nocase matching scheme uses case-insensitive
matching behavior.

The filter for the collection is a Tcl list of
wildcards, and must follow standard Tcl or
Timing Analyzer-extension substitution rules. See the help
for use_timing_analyzer_style_escaping for details.
Example Usage
#Get the partitions matching the filter
get_partitions *

#Get the collection of cells inside partitions matching the filter
get_partitions * -cell
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: This command is not supported in this version of the software.