getBuildArgs

Get build arguments from build information

Syntax

[identifiers,values] = getBuildArgs(buildinfo,includeGroupIDs,excludeGroupIDs)

Description

[identifiers,values] = getBuildArgs(buildinfo,includeGroupIDs,excludeGroupIDs) returns build argument identifiers and values from build information.

The function requires the buildinfo, identifiers, and values arguments. You can use optional includeGroupIDs and excludeGroupIDs arguments. These optional arguments let you include or exclude groups selectively from the build arguments returned by the function.

If you choose to specify excludeGroupIDs and omit includeGroupIDs, specify a null character vector ('') for includeGroupIDs.

Examples

Get Build Arguments from Build Information

After you build a project, the build information is available in the buildInfo.mat file. Retrieve the build arguments from the build information object.

load buildInfo.mat
[buildArgIds,buildArgValues] = getBuildArgs(buildInfo);

To get the value of a single build argument from the build information, you can use the findBuildArg (Simulink Coder) function.

To view the build argument identifiers, enter:

buildArgIds

To view the build argument values, enter:

buildArgValues

Input Arguments

buildinfo — Build information object

object

RTW.BuildInfo object that contains information for compiling and linking generated code.

includeGroupIDs — Group names of build arguments to include in the return from the function

cell array of character vectors | string

Group names of build arguments to include in the return from the function, specified as a string or a cell array of character vectors. To view the group name of a build argument, access the Group property of the corresponding object.

Example: ''

excludeGroupIDs — Group names of build arguments to exclude from the return from the function

cell array of character vectors | string

Group names of build arguments to exclude from the return from the function, specified as a string or a cell array of character vectors. To view the group name of a build argument, access the Group property of the corresponding object.

Example: ''

Output Arguments

identifiers — Build argument names

cell array of character vectors

Names of the build arguments.

values — Build argument values

cell array of character vectors

Values of the build arguments.

Version History

Introduced in R2014a