Real-Time Workshop Pane: Code Style :: Configuration Parameters (Real-Time Workshop® Embedded Coder™)

Learn more about Real-Time Workshop Embedded Coder

Real-Time Workshop Pane: Code Style

On this page…
Real-Time Workshop: Code Style Tab Overview Parentheses level Preserve operand order in expression Preserve condition expression in if statement Convert if-elseif-else patterns to switch-case statements Preserve extern keyword in function declarations

On this page…

Real-Time Workshop: Code Style Tab Overview

Parentheses level

Preserve operand order in expression

Preserve condition expression in if statement

Convert if-elseif-else patterns to switch-case statements

Preserve extern keyword in function declarations

Real-Time Workshop: Code Style Tab Overview

Control optimizations for readability in generated code.

Configuration

This tab appears only if you specify an ERT based system target file.

Parentheses level

Specify parenthesization style for generated code.

Settings

Default: Nominal (Optimize for readability)

Minimum (Rely on C/C++ operators for precedence)

Inserts parentheses only where required by ANSI^[1] C or C++, or needed to override default precedence. For example:

isZero = var == 0;
if (isZero == 1 && (value < 3.7 ||value > 9.27)) {
   /* code */
   }

Nominal (Optimize for readability)

Inserts parentheses in a way that compromises between readability and visual complexity. The exact definition can change between releases.

Maximum (Specify precedence with parentheses)

Includes parentheses everywhere needed to specify meaning without relying on operator precedence. Code generated with this setting conforms to MISRA^®^[2] requirements. For example:

isZero = (var == 0);
if ((isZero == 1) && ((value < 3.7) || (value > 9.27))) {
   /* code */
   }

Command-Line Information

Parameter: ParenthesesLevel

Type: string

Value: 'Minimum' | 'Nominal' | 'Maximum'

Default: 'Nominal'

Recommended Settings

Application	Setting
Debugging	`Nominal (Optimized for readability)`
Traceability	`Nominal (Optimized for readability)`
Efficiency	`Minimum (Rely on C/C++ operators for precedence)`
Safety precaution	`Maximum (Specify precedence with parentheses)`

Preserve operand order in expression

Specify whether to preserve order of operands in expressions.

Settings

Default: off

On

Preserves the expression order specified in the model. Select this option to increase readability of the code or for code traceability purposes.

A*(B+C)

Off

Optimizes efficiency of code for nonoptimized compilers by reordering commutable operands to make expressions left-recursive. For example:

(B+C)*A

Command-Line Information

Parameter: PreserveExpressionOrder

Type: string

Value: 'on' | 'off'

Default: 'off'

Recommended Settings

Application	Setting
Debugging	On
Traceability	On
Efficiency	Off
Safety precaution	On

Preserve condition expression in if statement

Specify whether to preserve empty primary condition expressions in if statements.

Settings

Default: off

On

Preserves empty primary condition expressions in if statements, such as the following, to increase the readability of the code or for code traceability purposes.

if expression1
else
       statements2;
end

Off

Optimizes empty primary condition expressions in if statements by negating them. For example, consider the following if statement:

if expression1
else
       statements2;
end

By default, the code generator negates this statement as follows:

if ~expression1
        statements2;
end

Command-Line Information

Parameter: PreserveIfCondition

Type: string

Value: 'on' | 'off'

Default: 'off'

Recommended Settings

Application	Setting
Debugging	On
Traceability	On
Efficiency	Off
Safety precaution	On

Convert if-elseif-else patterns to switch-case statements

Specify whether to generate code for if-elseif-else decision logic as switch-case statements.

This readability optimization works on a per-model basis and applies only to:

Flow graphs in Stateflow^® charts
Embedded MATLAB^® functions in Stateflow charts
Embedded MATLAB Function blocks in that model

Settings

Default: off

On

Generate code for if-elseif-else decision logic as switch-case statements.

For example, assume that you have the following logic pattern:

if (x == 1) {
       y = 1;
} else if (x == 2) {
       y = 2;
} else if (x == 3) {
       y = 3;
} else {
       y = 4;
}

Selecting this check box converts the if-elseif-else pattern to the following switch-case statements:

switch (x) {
     case 1:
       y = 1; break;
     case 2:
       y = 2; break;
     case 3:
       y = 3; break;
     default:
       y = 4; break;
}

Off

Preserve if-elseif-else decision logic in generated code.

Command-Line Information

Parameter: ConvertIfToSwitch

Type: string

Value: 'on' | 'off'

Default: 'off'

Recommended Settings

Application	Setting
Debugging	No impact
Traceability	Off
Efficiency	On (execution, ROM), No impact (RAM)
Safety precaution	No impact

Preserve extern keyword in function declarations

Specify whether to include the extern keyword in function declarations in the generated code.

Note The extern keyword is optional for functions with external linkage. It is considered good programming practice to include the extern keyword in function declarations for code readability.

Settings

Default: on

On

Include the extern keyword in function declarations in the generated code. For example, the generated code for the demo model rtwdemo_hyperlinks contains the following function declarations in rtwdemo_hyperlinks.h:

/* Model entry point functions */
extern void rtwdemo_hyperlinks_initialize(void);
extern void rtwdemo_hyperlinks_step(void);

The extern keyword explicitly indicates that the function has external linkage. The function definitions in this example are in the generated file rtwdemo_hyperlinks.c.

Off