MATLAB Compiler

Using Bundle Files

Bundle files provide a convenient way to group sets of MATLAB Compiler options and recall them as needed. The syntax of the bundle file option is

• -B <filename>[:<a1>,<a2>,...,<an>]
  

When used on the mcc command line, the bundle option -B replaces the entire string with the contents of the specified file. The file should contain only mcc command line options and corresponding arguments and/or other filenames. The file may contain other -B options.

A bundle file can include replacement parameters for Compiler options that accept names and version numbers. For example, there is a bundle file for C shared libraries, csharedlib, that consists of

• -W lib:%1% -T link:lib
  

To invoke the Compiler to produce a C shared library using this bundle, you could use

• mcc -B csharedlib:mysharedlib myfile.m myfile2.m
  

In general, each %n% in the bundle file will be replaced with the corresponding option specified to the bundle file. Use %% to include a % character. It is an error to pass too many or too few options to the bundle file.

You can place options that you always set in an mccstartup file. For more information, see Setting Up Default Options.

Note    You can use the -B option with a replacement expression as is at the DOS or UNIX prompt. To use -B with a replacement expression at the MATLAB prompt, you must enclose the expression that follows the -B in single quotes when there is more than one parameter passed. For example,     >>mcc -B csharedlib:libtimefun weekday data tic calendar toc can be used as is at the MATLAB prompt because libtimefun is the only parameter being passed. If the example had two or more parameters, then the quotes would be necessary as in     >>mcc -B 'cexcel:component,class,1.0' weekday data tic calendar toc

This table shows the available bundle files.

Bundle File Name	Creates	Contents
ccom	COM Object	-W com:<component_name>,<class_name>,<version> -T link:lib
cexcel	Excel COM Object	-W excel:<component_name>,<class_name>,<version> -T link:lib -b
cppcom	COM Object (same as ccom)	-B ccom:<component_name>,<class_name>,<version>
cppexcel	Excel COM Object (same as cexcel)	-B cexcel:<component_name>,<class_name>, <version>
cpplib	C++ Library	-W cpplib:<shared_library_name> -T link:lib
csharedlib	C Shared Library	-W lib:<shared_library_name> -T link:lib

Using Pathnames

Using Wrapper Files

© 1994-2005 The MathWorks, Inc.