addCompileFlags - Add compiler options to model build information

Syntax

addCompileFlags(buildinfo, options, groups)

groups is optional.

Arguments

buildinfo

Build information returned by RTW.BuildInfo.

options

A character array or cell array of character arrays that specifies the compiler options to be added to the build information. The function adds each option to the end of a compiler option vector. If you specify multiple options within a single character array, for example '-Zi -Wall', the function adds the string to the vector as a single element. For example, if you add '-Zi -Wall' and then '-O3', the vector consists of two elements, as shown below.

'-Zi -Wall'    '-O3'

groups (optional)

A character array or cell array of character arrays that groups specified compiler options. You can use groups to

Document the use of specific compiler options
Retrieve or apply collections of compiler options

You can apply

A single group name to one or more compiler options
Multiple group names to collections of compiler options (available for nonmakefile build environments only)

To... Specify groups as a...

Apply one group name to all compiler options Character array.

Apply different group names to compiler options Cell array of character arrays such that the number of group names matches the number of elements you specify for options.

To...	Specify `groups` as a...
Apply one group name to all compiler options	Character array.
Apply different group names to compiler options	Cell array of character arrays such that the number of group names matches the number of elements you specify for `options`.

Note

To specify compiler options to be used in the standard Simulink Coder makefile build process, specify groups as either 'OPTS' or 'OPT_OPTS'.
To control compiler optimizations for your Simulink Coder makefile build at Simulink GUI level, use the Compiler optimization level parameter on the Code Generation pane of the Simulink Configuration Parameters dialog box. The Compiler optimization level parameter provides
- Target-independent values Optimizations on (faster runs) and Optimizations off (faster builds), which allow you to easily toggle compiler optimizations on and off during code development
- The value Custom for entering custom compiler optimization flags at Simulink GUI level (rather than at other levels of the build process)
If you use the configuration parameter Make command to specify compiler options for your Simulink Coder makefile build using OPT_OPTS, MEX_OPTS (except MEX_OPTS="-v"), or MEX_OPT_FILE, the value of Compiler optimization level is ignored and a warning is issued about the ignored parameter.

Description

The addCompileFlags function adds specified compiler options to the model build information. Simulink Coder stores the compiler options in a vector. The function adds options to the end of the vector based on the order in which you specify them.

In addition to the required buildinfo and options arguments, you can use an optional groups argument to group your options.

Examples

Add the compiler option -O3 to build information myModelBuildInfo and place the option in the group OPTS.
```
myModelBuildInfo = RTW.BuildInfo;
addCompileFlags(myModelBuildInfo, '-O3', 'OPTS');
```
Add the compiler options -Zi and -Wall to build information myModelBuildInfo and place the options in the group OPT_OPTS.
```
myModelBuildInfo = RTW.BuildInfo;
addCompileFlags(myModelBuildInfo, '-Zi -Wall', 'OPT_OPTS');
```
For a nonmakefile build environment, add the compiler options -Zi, -Wall, and -O3 to build information myModelBuildInfo. Place the options -Zi and -Wall in the group Debug and the option -O3 in the group MemOpt.
```
myModelBuildInfo = RTW.BuildInfo;
addCompileFlags(myModelBuildInfo, {'-Zi -Wall' '-O3'}, ...
  {'Debug' 'MemOpt'});
```