Remove files or directories from a fileset
Syntax
remove_files [‑fileset <arg>] [‑quiet] [‑verbose] <files>...
Returns
List of files that were removed.
Usage
Name | Description |
---|---|
[-fileset]
|
Fileset name |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
<files>
|
Name of the file(s) to be removed |
Categories
Description
Removes the specified file objects from the current or specified fileset. The file is removed from the current project, but is not removed from the disk.
Files can be specified as file name strings, or as file objects returned by the get_files
command. When specified as strings, the file is looked for in the current or specified fileset. When the file object is specified by get_files
, the fileset is defined by the object, and -fileset
is ignored.
When successful, this command returns nothing. If the specified file is not found, an error is returned.
Arguments
-fileset <arg>
- (Optional) The name of the fileset to locate the specified files. As a default, the files will be removed from the current fileset as defined by the current_fileset
command.
-quiet
- (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose
- (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config
command.
<files>
- (Required) The name of the files to remove from the project.
Examples
The following example removes the file named C:/Design/top.xdc from the constraint set constrs_1:
remove_files -fileset constrs_1 C:/Design/top.xdc
Multiple files can be specified as follows:
remove_files -fileset sim_1 top_tb1.vhdl top_tb2.vhdl
The following example gets all the file objects in the current project, and removes them:
remove_files [get_files]