EMX array utility functions identifier format

Customize generated identifiers for emxArray utility functions

Model Configuration Pane: Code Generation / Identifiers

Description

Customize generated identifiers for emxArray (embeddable mxArray) utility functions. The code generator produces emxArray types for variable-size arrays that use dynamically allocated memory. It produces emxArray utility functions that create and interact with variables that have an emxArray type. This parameter applies to MATLAB^® code in a MATLAB Function block, a Stateflow^® chart, or a System object™ associated with a MATLAB System block. This parameter does not apply to:

Input or output signals
Parameters
Global variables
Discrete state properties of System objects associated with a MATLAB System block

Dependencies

This parameter:

Appears only for ERT-based targets.
Requires an Embedded Coder^® when generating code.

Settings

emx$M$N | string

Enter a macro that specifies whether, and in what order, certain text is to be included in the generated identifier. The macro can include a combination of the following format tokens.

Token Description

Token	Description
`$M`	Insert name-mangling text if required to avoid naming collisions. Required.
`$N`	Insert the utility function name into identifier. For example, `Init_real`.
`$R`	Insert root model name into identifier, replacing unsupported characters with the underscore (_) character. Required for model referencing.

$M

Insert name-mangling text if required to avoid naming collisions.

Required.

$N

Insert the utility function name into identifier. For example, Init_real.

$R

Insert root model name into identifier, replacing unsupported characters with the underscore (_) character.

Required for model referencing.

Tips

The code generator applies the identifier format specified by this parameter before it applies the formats specified by other identifier format control parameters.
Where possible, increase the Maximum identifier length to accommodate the length of the identifiers you expect to generate. Reserve at least three characters for name-mangling text.
If you specify $R, the value that you specify for Maximum identifier length must be large enough to accommodate full expansions of the $R and $M tokens.

Recommended Settings

Application	Setting
Debugging	No impact
Traceability	No impact
Efficiency	No impact
Safety precaution	No recommendation

Programmatic Use

Parameter: CustomSymbolStrEmxFcn

Type: character vector

Value: valid combination of tokens

Default: emx$M$N

Version History

Introduced in R2017a