External Interfaces/API

Specifying an Options File

You can use the -f option to specify an options file on either UNIX or Windows. To use the -f option, at the MATLAB prompt type

• mex filename -f <optionsfile>
  

and specify the name of the options file along with its pathname. The Options Files table, below, contains a list of the options files included with MATLAB.

There are several situations when it may be necessary to specify an options file every time you use the mex script. These include:

• (Windows and UNIX) You want to use a different compiler (and not use the -setup option), or you want to compile MAT or engine stand-alone programs.
• (UNIX) You do not want to use the system C compiler.

Preconfigured Options Files

MATLAB includes some preconfigured options files that you can use with particular compilers. The Options Files table lists the compilers whose options files are included with this release of MATLAB.

Table 1-2: Options Files  

Platform	Compiler	Options File
Windows	Borland C++, Version 5.0 & 5.2	bccopts.bat
	Borland C++Builder 3.0 (Borland C++, Version 5.3)	bcc53opts.bat
	Borland C++Builder 4.0 (Borland C++, Version 5.4)	bcc54opts.bat
	Borland C++Builder 5.0 (Borland C++, Version 5.5)	bcc55opts.bat
	Lcc C Compiler, bundled with MATLAB	lccopts.bat
	Microsoft C/C++, Version 5.0	msvc50opts.bat
	Microsoft C/C++, Version 6.0	msvc60opts.bat
	Watcom C/C++, Version 10.6	watcopts.bat
	Watcom C/C++, Version 11	wat11copts.bat
	DIGITAL Visual Fortran, Version 5.0	df50opts.bat
	Compaq Visual Fortran, Version 6.1	df61opts.bat
	Compaq Visual Fortran, Version 6.6	df66opts.bat
	Borland C, Version 5.0 & 5.2, for Engine and MAT stand-alone programs	bccengmatopts.bat
	Borland C, Version 5.3, for Engine and MAT stand-alone programs	bcc53engmatopts.bat
	Borland C, Version 5.4, for Engine and MAT stand-alone programs	bcc54engmatopts.bat
	Borland C, Version 5.5, for Engine and MAT stand-alone programs	bcc55engmatopts.bat
	Lcc C compiler for Engine and MAT stand-alone programs,	lccengmatopts.bat
	Microsoft Visual C for Engine and MAT stand-alone programs, Version 5.0	msvc50engmatopts.bat
	Microsoft Visual C for Engine and MAT stand-alone programs, Version 6.0	msvc60engmatopts.bat
	Watcom C for Engine and MAT stand-alone programs, Version 10.6	watengmatopts.bat
	Watcom C for Engine and MAT stand-alone programs, Version 11	wat11engmatopts.bat
	DIGITAL Visual Fortran for MAT stand-alone programs, Version 5.0	df50engmatopts.bat
	Compaq Visual Fortran for MAT stand-alone programs, Version 6.1	df60engmatopts.bat
UNIX	System ANSI Compiler	mexopts.sh
	GCC	gccopts.sh
	System ANSI Compiler for Engine stand-alone programs	engopts.sh
	System ANSI Compiler for MAT stand-alone programs	matopts.sh

An up-to-date list of options files is available from our FTP server, ftp://ftp.mathworks.com/pub/tech-support/docexamples/apiguide/R12/bin. For a list of all the compilers supported by MATLAB, access the MathWorks Technical Support Web site at http://www.mathworks.com/support.

Note    The next section, Custom Building MEX-Files, contains specific information on how to modify options files for particular systems.

Testing Your Configuration on Windows

Custom Building MEX-Files