get_logiclock_contents (::quartus::incremental_compilation)

The following table displays information for the get_logiclock_contents Tcl command:

Tcl Package and Version

Belongs to ::quartus::incremental_compilation 1.1

Syntax get_logiclock_contents [-h | -help] [-long_help] [-node_locations] [-region <region name> ] [-root_region]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-node_locations Option to list node-locations instead of region assignments
-region <region name> Region name
-root_region Root region name
Description 
Returns assigned contents or back-annotated nodes for the 
specified region. The command returns a list of all the
region assignments to the LogicLock(TM) region specified 
by the "-region" option.

Each member is represented by one element in the list. 
Each member has the following format:

{{<from>} {<to>} {<region>} {<exclude_from>} {<exclude_to>} {<exclude_node>}} 

When the member is a simple member, rather than a path 
member, only the second and third elements are valid. (The 
first element is always empty in this case so that common 
parsing code can be used.)

When you use the "-node_locations" option, the back-annotated 
contents are returned.
Example Usage 
package require ::quartus::incremental_compilation

project_open my_design

## Get a list of region members
set members [get_logiclock_contents -region region_one]

## Parse elements of member list
foreach member $members {
	set from			[lindex $member 0]
	set to			  [lindex $member 1]
	set region		 [lindex $member 2]
	set exclude_from [lindex $member 3]
	set exclude_to	[lindex $member 4]
	## Do something with member attributes
	...
}

project_close
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: LogicLock not initialized. Initialize the LogicLock data structures using the initialize_logiclock command. The LogicLock datastructures can go out of date after changing projects, revisions, or devices; if so, use a subsequent initialize_logiclock command.
TCL_ERROR 1 ERROR: Project has no active revision. Make sure there is an open, active revision.
TCL_ERROR 1 ERROR: No project is currently open. Open an existing project or create a new project.