getLinkFlags

Get link options from build information

Syntax

options = getLinkFlags(buildinfo,includeGroups,excludeGroups)

Description

options = getLinkFlags(buildinfo,includeGroups,excludeGroups) returns linker options from the build information.

The function requires the buildinfo argument. You can use optional includeGroups and excludeGroups arguments. These optional arguments let you include or exclude groups selectively from the compiler options returned by the function.

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

Examples

Get Linker Options from Build Information

Get the linker options from the build information, myBuildInfo.

myBuildInfo = RTW.BuildInfo;
addLinkFlags(myBuildInfo,{'-MD -Gy' '-T'},'OPTS');
linkflags = getLinkFlags(myBuildInfo);

>> linkflags

linkflags = 

    '-MD -Gy'    '-T'

Get Linker Options with Include Group Argument

Get the linker options with the group name Debug from the build information, myBuildInfo.

myBuildInfo = RTW.BuildInfo;
addLinkFlags(myBuildInfo,{'-MD -Gy' '-T'}, ...
   {'Debug' 'MemOpt'});
linkflags = getLinkFlags(myBuildInfo,{'Debug'});

>> linkflags

linkflags = 

    '-MD -Gy'

Get Linker Options with Exclude Group Argument

Get the linker options from the build information myBuildInfo, except those options with the group name Debug.

myBuildInfo = RTW.BuildInfo;
addLinkFlags(myBuildInfo,{'-MD -Gy' '-T'}, ...
   {'Debug' 'MemOpt'});
linkflags = getLinkFlags(myBuildInfo,'',{'Debug'});

>> linkflags

linkflags = 

    '-T'

Input Arguments

buildinfo — Build information object

object

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

includeGroups — Group names of linker options to include in the return from the function

cell array of character vectors | string

Group names of linker options 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 linker option, access the Group property of the corresponding object.

Example: ''

excludeGroups — Group names of linker options to exclude from the return from the function

cell array of character vectors | string

Group names of linker options 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 linker option, access the Group property of the corresponding object.

Example: ''

Output Arguments

options — Linker options

cell array of character vectors

Linker options from the build information.

Version History

Introduced in R2006a