Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 10/04/2021
Public

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

Document Table of Contents

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