getFullFileList

Get list of files from build information

Syntax

[fPathNames,names] = getFullFileList(buildinfo,fcase)

Description

[fPathNames,names] = getFullFileList(buildinfo,fcase) returns the fully qualified paths and names of files, or files of a selected type (source, include, or nonbuild), from the build information.

The function requires the buildinfo, fPathNames, and names arguments. You can use the optional fcase argument. This optional argument lets you include or exclude file cases selectively from file list returned by the function.

To ensure that header files are added to the file list (for example, header files in the _sharedutils (Simulink Coder) folder), run before getFullFileList.

The packNGo (Simulink Coder) function calls getFullFileList to return a list of files in the build information before processing files for packaging.

The makefile for the build resolves file locations based on source paths and rules. The build process does not require you to resolve the path of every file in the build information. The getFullFileList function returns the path for each file:

• If a path was explicitly associated with the file when it was added.

• If you called updateFilePathsAndExtensions (Simulink Coder) to resolve file paths and extensions before calling getFullFileList.

Examples

Get Full List of Files

After building a project and loading the generated buildInfo.mat file, you can list the files stored in the build information object, buildInfo. This example returns information for the current project and its submodels.

From the code generation folder that contains the buildInfo.mat file, run:

bi = load('buildInfo.mat');
findIncludeFiles(bi.buildInfo);
[fPathNames, names] = getFullFileList(bi.buildInfo);

Get List of Source Files

If you use an fcase option, you limit the listing to the files stored in the build information object for the current project. This example returns information for the current project only (not for submodels).

[fPathNames,names] = getFullFileList(bi.buildInfo,'source');

Input Arguments

buildinfo — Build information object

object

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

fcase — File case to return from the build information

'' (default) | 'source' | 'include' | 'nonbuild'

The fcase argument selects whether the function returns the full list for files in the build information or returns selected cases of files. If you omit the argument or specify a null character vector (''), the function returns the files from the build information.

Specify	Function Action
'source'	Returns source files from the build information.
'include'	Returns include files from the build information.
'nonbuild'	Returns nonbuild files from the build information.

Example: 'source'

Output Arguments

fPathNames — Fully qualified file paths

cell array of character vectors

Fully qualified file paths from the build information.

names — File names

cell array of character vectors

File names from the build information.

Version History

Introduced in R2008a