Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 6/20/2022
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.35.39. 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
Description
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
create_timing_netlist

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

delete_timing_netlist
project_close
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.