Description
Create property for class of objects(s).
Syntax
create_property [-description <arg>] [-type <arg>] [-enum_values <args>] [-default_value <arg>] [-file_types <args>] [-display_text <arg>] [-quiet] [-verbose] <name> <class>
Returns
The property that was created if success, "" if failure.
Usage
Name | Description |
---|---|
[-description ] |
Description of property |
[-type ] |
Type of property to create; valid values are: string, int, long, double, bool, enum, file Default: string |
[-enum_values ] |
Enumeration values |
[-default_value ] |
Default value of type string |
[-file_types ] |
File type extensions (without the dot) |
[-display_text ] |
Text to display when selecting the file in file browser |
[-quiet ] |
Ignore command errors |
[-verbose ] |
Suspend message limits during command execution |
<name> | Name of property to create |
<class> | Object type to create property for; valid values are: design, net, cell, pin, port, pblock, interface, fileset |
Categories
PropertyAndParameter
Description
Creates a new property of the type specified with the user-defined namefor the specified class of objects. The property that is created can be assigned to an object of the specified class with the set_property command, but is not automatically associated with all objects of that class.
The report_property -all
command will not report the
newly created property for an object of the specified class until the property has
been assigned to that object
Arguments
-description
- (optional) Provide a
description of the property being created. The description will be returned by the
HSM help system when the property is queried.
-type
- (optional) The type of
property to create. Allowed property types include:
- string - Allows the new property to be defined with string values. This is the default value when -type is not specified.
- int - Allows the new property to be defined with short four-byte signed integer values with a range of -2,147,483,648 to 2,147,483,647. If a floating point value is specified for an int property type, the HSM tool will return an error.
- long - Specifies signed 64-bit integers with value range of -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807. If a floating point value is specified for an long property type, the tool will return an error.
- double - Allows the new property value to be defined with a floating point number.
- bool - Allows the new property to be defined as a boolean with a true (1, or yes) or false (0, or no) value.
- enum - An enumerated data type, with the valid enumerated values specified by the -enum_values option.
- string_list - A Tcl list of string values.
- int_list - A Tcl list of integer values.
- double_list - A Tcl list of floating point values.
-enum_values
<args> - (optional)
A list of enumerated values that the property can have. The list must be enclosed in
braces, {}, with values separated by spaces. This option can only be used with -type
enum.
-default_value
<args> -
(optional) The default value to assign to the property. This option can be used for
string, int, bool, and enum type properties.
<name> - (required) The name of the property to be defined. The name is case sensitive.
<class> - (required) The class of object to assign the new property to. All objects of the specified class will be assigned the newly defined property. Valid classes are: design, net, cell, pin, port, Pblock, interface, and fileset.
-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.Examples
Create a property called PURPOSE for cell objects:
common::create_property PURPOSE cell
Create a pin property called COUNT which holds an Integer value:
common::create_property -type int COUNT pin