enable_natural_bus_naming (::quartus::misc)

The following table displays information for the enable_natural_bus_naming Tcl command:

Tcl Package and Version

Belongs to ::quartus::misc 1.0

Syntax enable_natural_bus_naming [-h | -help] [-long_help]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
Enables natural bus naming so that square brackets for bus names do
not have to be escaped to prevent Tcl from interpreting them as

Bus names have the following format:

<bus name>[<bus index>] or <bus name>[*]

The <bus name> portion is a string of alphanumeric characters.  The
<bus index> portion is an integer greater than or equal to zero or it
can be the character "*" used for string matching.  Notice that the
<bus index> is enclosed by the square brackets "[" and "]". For
example, "a[0]" and "a[*]" are supported bus names.

Many Quartus Prime Tcl commands allow bus names in their arguments, such

set_location_assignment -to address[10] Pin_M20

If natural bus naming is enabled, you can just use address[10] instead
of having to excape the square brackets into address\[10\].

There are also Quartus Prime Tcl commands that take Tcl string match
patterns in their arguments, such as:

get_all_instance_assignments -name location -to address[10]

Since Tcl string matching take string patterns containing special
characters from the set "*?\[]" as values, address[10] would be
interpreted incorrectly. By enabling natural bus naming, these Tcl
commands will automatically detect address[10] as a bus name so that
you don't have to doubly escape the brackets into address\\\[10\\\].

To disable natural bus naming, type

For more information on the effects of disabling natural bus naming,
type "disable_natural_bus_naming -h".
Example Usage
# Enables natural bus naming
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful