Scripting

project remove_assignment (Tcl Script API Function)



The project remove_assignment function has the following format:

Syntax project remove_assignment <entity> <section_identifier> <source> <destination> <variable> <value>
Arguments

<entity>

If this assignment is for a particular design entity, the design entity name. If there is no design entity, use empty double quotation marks ("").
If you specify a design entity, the Quartus® II software removes the assignment from only the Entity Settings File (.esf) for the design entity. Otherwise, the Quartus II software removes the assignment from the Project Settings File (.psf) and Project Configuration File (.quartus) for the project, and not assignments from any ESF.

<section_identifier>

The name of the section in the ESF, PSF or QUARTUS File that contains the assignment. If you want to remove the assignment from all possible sections in the PSF and QUARTUS File, or in an ESF, use empty double quotation marks("").

<source>

If required, the first statement in a range of statements that contain the assignment. If there is no range, or you want to remove the all the statements with the assignment, use empty double quotation marks ("").

<destination>

The statement containing the assignment, or, for a range of statements, the last statement in the range. If you want to remove all the statements with the assignment, use empty double quotation marks ("").

<variable>

The keyword for the assignment you want to remove.

<value>

The value of the assignment you want to remove.

Return Value

Code Name Code String Return
TCL_OK 0 project assignment removed
TCL_OK 0 entity assignment removed
TCL_ERROR 1 unable to remove project assignment(s)
TCL_ERROR 1 unable to remove entity assignment(s)
TCL_ERROR 1 unable to find entity: <entity>
TCL_ERROR 1 no project is currently open
TCL_ERROR 1 no assignment removed because it did not exist
TCL_ERROR 1 wrong # args: should be "remove_assignment entity section_id source destination variable value"
TCL_ERROR 1 section identifier is required but was not specified
TCL_ERROR 1 section identifier was specified but is not required
TCL_ERROR 1 illegal or missing destination
TCL_ERROR 1 unable to write to disk
Description Removes the specified assignment (by removing the specified statement(s) that contain the assignment) from the specified section(s) of the project's current PSF and QUARTUS File or, if you specified a design entity, in one of the project's ESFs.
To remove an entire section from the PSF, QUARTUS File, or ESF, specify the <section_identifier> and use empty double quotation marks ("") for <variable>.


Back to Top

- PLDWorld -

 

Created by chm2web html help conversion utility.