Real-Time Workshop®

addSourceFiles - Add source files to model's build information

Syntax

addSourceFiles(buildinfo, filenames, paths, groups)

paths and groups are optional.

Arguments

buildinfo

Build information returned by RTW.BuildInfo.

filenames

A character array or cell array of character arrays that specifies names of the source files to be added to the build information.

The filename strings can include wildcard characters, provided that the dot delimiter (.) is present. Examples are '*.*', '*.c', and '*.c*'.

The function adds the filenames to the end of a vector in the order that you specify them.

The function removes duplicate source file entries that

• You specify as input

• Already exist in the source file vector

• Have a path that matches the path of a matching filename

A duplicate entry consists of an exact match of a path string and corresponding filename.

paths (optional)

A character array or cell array of character arrays that specifies paths to the source files. The function adds the paths to the end of a vector in the order that you specify them. If you specify a single path as a character array, the function uses that path for all files.

groups (optional)

A character array or cell array of character arrays that groups specified source files. You can use groups to

• Document the use of specific source files

• Retrieve or apply groups of source files

You can apply

• A single group name to a source file

• A single group name to multiple source files

• Multiple group names to collections of multiple source files

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

Description

The addSourceFiles function adds specified source files to the model's build information. The Real-Time Workshop^® software stores the source files in a vector. The function adds the filenames to the end of the vector in the order that you specify them.

In addition to the required buildinfo and filenames arguments, you can specify optional paths and groups arguments. You can specify each optional argument as a character array or a cell array of character arrays.

If you choose to specify groups, but omit paths, specify a null string ('') for paths.

Examples

• Add the source file driver.c to build information myModelBuildInfo and place the file in the group Drivers.

  myModelBuildInfo = RTW.BuildInfo;
  addSourceFiles(myModelBuildInfo, 'driver.c', ...
  '/pathto/mysources', 'Drivers');
  

• Add the source files test1.c and test2.c to build information myModelBuildInfo and place the files in the group Tests.

  myModelBuildInfo = RTW.BuildInfo;
  addSourceFiles(myModelBuildInfo, ...
  {'test1.c' 'test2.c'}, ...
  '/pathto/mysources', 'Tests');
  

• Add the source files test1.c, test2.c, and driver.c to build information myModelBuildInfo. Group the files test1.c and test2.c with the string Tests and the file driver.c with the string Drivers.

  myModelBuildInfo = RTW.BuildInfo;
  addSourceFiles(myModelBuildInfo, ...
  {'test1.c' 'test2.c' 'driver.c'}, ... 
  '/pathto/mysources', ...
  {'Tests' 'Tests' 'Drivers'});
  

• Add all of the .c files in a specified directory to build information myModelBuildInfo and place the files in the group CFiles.

  myModelBuildInfo = RTW.BuildInfo;
  addIncludeFiles(myModelBuildInfo, ... 
  '*.c', '/pathto/mysources', 'CFiles');

See Also

addIncludeFiles, addIncludePaths, addSourcePaths, updateFilePathsAndExtensions, updateFileSeparator
Programming a Post Code Generation Command

addNonBuildFiles

addSourcePaths