Modifying object names when inserted into C++ code (C++ code)
Model object names in Modeler may be invalid if inserted directly into C++ code, for example, they may contain spaces. For this reason, ACS modifies Modeler object names when they are inserted into your C++ code. This modifying of names is controlled through mangle.ini. ACS uses the mangle.ini file to match model object names with their associated C++ code elements. Typically, you do not have to change the mangle.ini file.
You can avoid using the mangled name of an item by specifying the exact name you want to insert into your code through the item's CODE_GENERATION_NAME property. If you specify a CODE_GENERATION_NAME value for an item, ACS inserts that name into the code as is.
The mangle.ini file resides in the PTC Integrity Modeler\Modeler\System\CppGen folder.
For each Modeler object type, you can add prefixes and suffixes. Specify the %parent% keyword to include the name of an item's parent item in a prefix or suffix.
• Unnamed Roles are generated with an 'r' prefix, and named Roles are generated without an 'r' prefix. Prefixing and suffixing of named and unnamed Roles is controlled through the [role] and [unnamed role] sections of the mangle.ini file. For example, if you want all Roles to be generated with a 'r' prefix, ensure that the Role sections of the mangle.ini file are as follows:
[role] AddPrefix=r AddSuffix=
[unnamed role] AddPrefix=r AddSuffix=
The mangle.ini file specifies a maximum name length is 250 characters and the replacement or deletion of invalid characters. For example:
• . is replaced with _
• - is replaced with _
• <space> is replaced with _
• & is deleted
• * is deleted
• The mangle.ini file refers to a Package as a Category.
• Model Object References that are generated from rich text (such as Operation body code) are also changed through the mangle.ini file.
• When reverse engineering C++ code, the Reverser uses the Mangle.ini file to match the names of C++ Code elements with the mangled names of model items.
• The SDL scripts use %Custom "C++ Name" to return the mangled scoped name of an item, or %Custom "Unscoped C++ Name" to return the mangled unscoped name of an item.
