Controlling Code Generation (MATLAB Compiler)

MATLAB Compiler

Generated Code

This chapter investigates the generated header files, interface functions, and wrapper functions for the C MEX, stand-alone C and C++ targets, and C and C++ libraries.

When you use the MATLAB Compiler to compile an M-file, it generates these files:

C or C++ code, depending on your target language (-L) specification
Header file
Wrapper file, depending on the -W option

The C or C++ code that is generated by the Compiler and the header file are independent of the final target type and target platform. That is, the C or C++ code and header file are identical no matter what the desired final output. The wrapper file provides the code necessary to support the output executable type. So, the wrapper file is different for each executable type.

Table 5-1, Compiler-Generated Files, shows the names of the files generated when you compile a generic M-file Table 5-1(file.m) for the MEX and stand-alone targets. The table also shows the files generated when you compile a set of files (filelist) for the library target and the COM target.

Table 5-1: Compiler-Generated Files

C
C++

Header
file.h
file.hpp

Code
file.c
file.cpp

Main Wrapper
(-W main)
file_main.c
file_main.cpp

MEX Wrapper
(-W mex)
file_mex.c
N/A (C++ MEX-files are not supported.)

Simulink Wrapper
(-W simulink)
file_simulink.c
N/A (C++ MEX-files are not supported.)

Library
(-W lib:filelist)
filelist.c filelist.h filelist.exports filelist.mlib
filelist.cpp filelist.hpp filelist.mlib

COM Component
(-W com:compname[,classname[,major.minor]])
(-W comHG:compname[,classname[,major.minor]])
compname_idl.idl compname_com.hpp compname_com.cpp compname_dll.cpp compname.def compname.rc
compname_idl.idl compname_com.hpp compname_com.cpp compname_dll.cpp compname.def compname.rc

Table 5-1: **Compiler-Generated Files**
	C	C++
Header	`file.h`	`file.hpp`
Code	`file.c`	`file.cpp`
Main Wrapper (-W main)	`file_main.c`	`file_main.cpp`
MEX Wrapper (-W mex)	`file_mex.c`	N/A (C++ MEX-files are not supported.)
Simulink Wrapper (-W simulink)	`file_simulink.c`	N/A (C++ MEX-files are not supported.)
Library (-W lib:filelist)	`filelist.c filelist.h filelist.exports filelist.mlib`	`filelist.cpp filelist.hpp filelist.mlib`
COM Component (-W com:compname[,classname[,major.minor]]) (-W comHG:compname[,classname[,major.minor]])	`compname_idl.idl compname_com.hpp compname_com.cpp compname_dll.cpp compname.def compname.rc`	`compname_idl.idl compname_com.hpp compname_com.cpp compname_dll.cpp compname.def compname.rc`

Note Many of the code snippets generated by the MATLAB Compiler that are used in this chapter use the -F page-width option to produce readable code that fits nicely on the book's printed page. For more information about the page-width option, see Formatting Compiler-Generated Code.

Code Generation Overview Compiling Private and Method Functions