Main Content

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.

TokenDescription
$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

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precautionNo recommendation

Programmatic Use

Parameter: CustomSymbolStrEmxFcn
Type: character vector
Value: valid combination of tokens
Default: emx$M$N

Version History

Introduced in R2017a