hnlMapName

hnlMapName( 
t_cdsName
)
=> name

Description

Returns a new mapped name if the argument specified as the cdsName string is not a valid name for the target simulator. Otherwise, the cdsName string is returned.

The hnlMapIfFirstChar, hnlMapIfInName, hnlNamePrefix, and hnlMaxNameLength variables are used to determine if a name is invalid. If an alternate string is specified for a invalid character, the string replaces the invalid character to create a new name. Characters can also be deleted from a name. If the name is too long or there is no character map, a new name is generated by using the prefix specified by the hnlNamePrefix variable, and suffixing it with a unique number. Assume the variables are set as follows:

hnlNamePrefix = "hnl_"
hnlMaxNameLength = 10 
hnlMapIfFirstChar = '(("@" "__") "0" "1")
hnlMapIfInName = '(("@" "__")) 

Then, hnlMapName("alu@99") would return "alu__99" and hnlMapName("0.Y") would return something like "hnl_12". For more information on the mapping abilities, refer to the hnlMapIfInName and hnlMapIfFirstChar variables, as well as the hnlInitMap function.

If you use this function, you cannot use the hnlMapInstName, hnlMapModelName, hnlMapTermName, and hnlMapNetName functions.

In the case of inherited terminals and inherited connections, netlister-generated names are returned. hnlMapName cannot be used interchangeably with hnlMapNetName or other type-specific name mapping functions in the same netlisting session.

Arguments

t_cdsName

String name to be mapped.

Value Returned

name	A new mapped name if the argument specified as the cdsName string is not a valid name for the target simulator;  otherwise, the cdsName string is returned.

Examples

hnlMapName( "alu@99" )

For net vdd! in the schematic view of cell inv, hnlMapName( "vdd!" ) returns "inh_vdd". For net gnd! in the same cellview, hnlMapName( "gnd!" ) returns "inh_gnd". These two are netlister-generated names due to inherited connection.

Related Topics

OSS Functions

Return to top