Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 10/04/2021

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

Document Table of Contents query_collection (::quartus::sta)

The following table displays information for the query_collection Tcl command:

Tcl Package and Version

Belongs to ::quartus::sta

Syntax query_collection [-h | -help] [-long_help] [-all] [-limit <limit_value> ] [-list_format] [-report_format] <collection>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-all Return all the collection objects.
-limit <limit_value> Set number of collection objects to return.
-list_format Return collection objects in a list format.
-report_format Return collection objects in a format of one element per line.
<collection> Object collection

Query collection objects. Collections can be obtained by Tcl commands such as get_clocks, get_ports, get_cells. If neither the -limit nor the -all option is specified, then first 20 objects (if the collection has more than 20 objects) or all objects (if the collection has less than or equal to 20 objects) are returned.

Example Usage
project_open chiptrip

set nodes [get_nodes Reg*]
# Get the first 100 nodes in the collection.
query_collection $nodes -limit 100

Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: Cannot find specified collection. Specify an existing collection.