Additional Information :: Calling C and Fortran Programs from MATLAB (External Interfaces)

External Interfaces

Additional Information

The following sections describe how to find additional information and assistance in building your applications. It covers the following topics:

Files and Directories - UNIX Systems

This section describes the directory organization and purpose of the files associated with the MATLAB API on UNIX systems.

The following figure illustrates the directories in which the MATLAB API files are located. In the illustration, <matlab> symbolizes the top-level directory where MATLAB is installed on your system.

Figure: Directories where MATLAB API files are located on UNIX

<matlab>/bin

The <matlab>/bin directory contains two files that are relevant for the MATLAB API.

mex UNIX shell script that creates MEX-files from C or Fortran MEX-file source code. matlabUNIX shell script that initializes your environment and then invokes the MATLAB interpreter.

This directory also contains the preconfigured options files that the mex script uses with particular compilers. This table lists the options files.

Table 3-4: Preconfigured Options Files
Options File
Description

engopts.sh
Used with the mex script and the system C or Fortran compiler to compile engine applications

gccopts.sh
Used with the mex script and the GNU C (gcc) compiler to compile MEX-files

matopts.sh
Used with the mex script and the system C or Fortran compiler to compile MAT-file applications

mexopts.sh
Used with the mex script and the system ANSI C or Fortran compiler to compile MEX-files

**Table 3-4: Preconfigured Options Files**
Options File	Description
`engopts.sh`	Used with the `mex` script and the system C or Fortran compiler to compile engine applications
`gccopts.sh`	Used with the `mex` script and the GNU C (`gcc`) compiler to compile MEX-files
`matopts.sh`	Used with the `mex` script and the system C or Fortran compiler to compile MAT-file applications
`mexopts.sh`	Used with the `mex` script and the system ANSI C or Fortran compiler to compile MEX-files

<matlab>/extern/lib/$ARCH

The <matlab>/extern/lib/$ARCH directory contains libraries, where $ARCH specifies a particular UNIX platform. On some UNIX platforms, this directory contains two versions of this library. Library filenames ending with .a are static libraries and filenames ending with .so or .sl are shared libraries.

<matlab>/extern/include

The <matlab>/extern/include directory contains the header files for developing C and C++ applications that interface with MATLAB.

The relevant header files for the MATLAB API are:

engine.hHeader file for MATLAB engine programs. Contains function prototypes for engine routines. mat.hHeader file for programs accessing MAT-files. Contains function prototypes for mat routines. matrix.hHeader file containing a definition of the mxArray structure and function prototypes for matrix access routines. mex.hHeader file for building MEX-files. Contains function prototypes for mex routines.

<matlab>/extern/src

The <matlab>/extern/src directory contains those C source files that are necessary to support certain MEX-file features such as argument checking and versioning.

Memory Management Compatibility Issues Files and Directories - Windows Systems