Real-Time Workshop^®

getIncludeFiles - Include files from model's build information

Syntax

files=getIncludeFiles(buildinfo, concatenatePaths, replaceMatlabroot, includeGroups, excludeGroups)

includeGroups and excludeGroups are optional.

Arguments

buildinfo

Build information returned by RTW.BuildInfo.

concatenatePaths

The logical value true or false.

If You Specify...	The Function...
`true`	Concatenates and returns each filename with its corresponding path.
`false`	Returns only filenames.

replaceMatlabroot

The logical value true or false.

If You Specify...	The Function...
`true`	Replaces the token `$(MATLAB_ROOT)` with the absolute path string for your MATLAB^® installation directory.
`false`	Does not replace the token `$(MATLAB_ROOT)`.

includeGroups (optional)

A character array or cell array of character arrays that specifies groups of include files you want the function to return.

excludeGroups (optional)

A character array or cell array of character arrays that specifies groups of include files you do not want the function to return.

Returns

Names of include files stored in the model's build information.

Description

The getIncludeFiles function returns the names of include files stored in the model's build information. Use the concatenatePaths and replaceMatlabroot arguments to control whether the function includes paths and your MATLAB root definition in the output it returns. Using optional includeGroups and excludeGroups arguments, you can selectively include or exclude groups of include files the function returns.

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

Examples

Get all include paths and filenames stored in build information myModelBuildInfo.

myModelBuildInfo = RTW.BuildInfo;
addIncludeFiles(myModelBuildInfo, {'etc.h' 'etc_private.h'...
'mytypes.h'}, {'/etc/proj/etclib' '/etcproj/etc/etc_build'...
'/common/lib'}, {'etc' 'etc' 'shared'});
incfiles=getIncludeFiles(myModelBuildInfo, true, false);
incfiles

incfiles = 

    [1x22 char]    [1x36 char]    [1x21 char]

Get the names of include files in group etc that are stored in build information myModelBuildInfo.