文档

本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

mex

从 C/C++ 或 Fortran 源代码编译 MEX 函数

语法

mex filenames
mex option1 ... optionN filenames
mex -setup lang
mex -setup -client engine [lang]

说明

示例

mex filenames 编译一个或多个 C、C++ 或 Fortran 源文件,并将这些文件链接到一个二进制 MEX 文件中。可从 MATLAB® 调用该 MEX 文件。filenames 指定源文件。另外还为独立 MATLAB 引擎和 MAT 文件应用程序编译可执行文件。

MATLAB 基于 filenames 参数的语言自动选择一个编译器(如果已安装)。

示例

mex option1 ... optionN filenames 使用指定编译选项进行编译。option1 ... optionN 参数补充或覆盖默认 mex 编译配置。

mex -setup lang 为给定 lang 选择一个编译器。使用此选项可更改给定语言的默认编译器。

mex -setup -client engine [lang] 选择用来编译引擎应用程序的编译器。如果要更改默认编译器,可以使用此选项。使用 lang 参数选择 Fortran 或 C++ 编译器。

示例

全部折叠

将单个 C 程序 yprime.c 编译为一个 MEX 文件。

在路径 c:\work 上创建一个可写文件夹,并将其设置为当前文件夹。

[s,msg,msgid] = mkdir('c:\work');
if (isempty(msgid))
    mkdir('c:\work')
end
cd c:\work

matlabroot/extern/examples 文件夹复制源代码示例。

copyfile(fullfile(matlabroot,'extern','examples','mex','yprime.c'),'.','f')

编译该 MEX 文件。输出显示特定于您的编译器的信息。

mex yprime.c
Building with 'MinGW64 Compiler  C '.
MEX completed successfully.

测试。

T=1;
Y=1:4;
yprime(T,Y)
ans =

    2.0000    8.9685    4.0000   -1.0947

要显示编译和链接命令及其他用于故障排除的信息,请使用详细模式。

mex -v -compatibleArrayDims yprime.c

输出显示特定于您的平台和编译器的信息。

通过将值 -Wall 追加到现有编译器标识符来编译 yprime.c 对应的 MEX 文件因为该值包括空格字符,所以您必须界定该字符串;界定所用字符取决于平台。

在 MATLAB 提示符处,使用 MATLAB 单引号 (')。

mex -v COMPFLAGS='$COMPFLAGS -Wall' yprime.c

对于基于 gcc/g++ 的 MinGW-w64 编译器,请使用 Linux® 编译器标识符。

mex -v CXXFLAGS='$CXXFLAGS -Wall' yprime.c

在 Windows® 命令提示符处,使用双引号 (")。

mex -v COMPFLAGS="$COMPFLAGS -Wall" yprime.c

Mac 和 Linux 上的 Shell 命令行处,使用单引号 (')。

mex -v CFLAGS='$CFLAGS -Wall' yprime.c

MEX 文件示例 fulltosparse 由两个 Fortran 源文件 loadsparse.Ffulltosparse.F 组成。要运行此示例,您需要在您的系统上安装支持的 Fortran 编译器。

将源文件复制到当前文件夹。

copyfile(fullfile(matlabroot,'extern','examples','refbook','loadsparse.F'),'.','f')
copyfile(fullfile(matlabroot,'extern','examples','refbook','fulltosparse.F'),'.','f')

编译 fulltosparse MEX 文件。MEX 文件名为 fulltosparse,这是因为 fulltosparse.F 是命令行上的第一个文件。输出包含特定于您的编译器的信息。

mex -largeArrayDims fulltosparse.F loadsparse.F
Building with 'Intel Visual Fortran Composer XE 2013 with Microsoft Visual Studio 2012'.
MEX completed successfully.

测试。

full = eye(5);
spar = fulltosparse(full)
spar =

    1,1         1
    2,2         1
    3,3         1
    4,4         1
    5,5         1

将当前文件夹中的所有 C 源文件组合为 MEX 文件 mymex。使用 -output 选项控制 MEX 文件的名称。

mex -output mymex *.c

在不执行命令的情况下,使用 -n 选项可预览编译命令详细信息。输出包含特定于您的平台和编译器的信息。

mex -n yprime.c

您可以链接到与源 MEX 文件分开编译的对象文件。

MEX 文件示例 fulltosparse 由两个 Fortran 源文件组成。fulltosparse 文件是入口例程(包含 mexFunction 子例程),loadsparse 包含计算例程。

要运行此示例,您需要在您的系统上安装支持的 Fortran 编译器。将计算子例程复制到当前文件夹。

copyfile(fullfile(matlabroot,'extern','examples','refbook','loadsparse.F'),'.','f')

编译子例程,并将对象文件放在单独的文件夹 c:\objfiles 中。

mkdir c:\objfiles
mex -largeArrayDims -c -outdir c:\objfiles loadsparse.F
Building with 'Intel Visual Fortran Composer XE 2013 with Microsoft Visual Studio 2012'.
MEX completed successfully.

将入口子例程复制到当前文件夹。编译 loadsparse 对象文件并与之链接。

copyfile(fullfile(matlabroot,'extern','examples','refbook','fulltosparse.F'),'.','f')
mex -largeArrayDims fulltosparse.F c:\objfiles\loadsparse.obj
Building with 'Intel Visual Fortran Composer XE 2013 with Microsoft Visual Studio 2012'.
MEX completed successfully.

要指定包含 MATLAB LAPACK 库子例程以处理复数例程的路径,请使用 -I 选项。要使用这些子例程,您的 MEX 文件必须访问头文件 fort.h

matrixDivideComplex.c 示例复制到当前文件夹。

copyfile(fullfile(matlabroot,'extern','examples','refbook','matrixDivideComplex.c'),'.','f')

通过串联 '-I'fort.h 文件的路径来创建 -I 参数。

ipath = ['-I' fullfile(matlabroot,'extern','examples','refbook')];

为 LAPACK 库文件和文件 fort.c 的名称和路径创建变量,这些变量包含复数处理例程。

lapacklib = fullfile(matlabroot,'extern','lib',computer('arch'),'microsoft','libmwlapack.lib');
fortfile = fullfile(matlabroot,'extern','examples','refbook','fort.c');

编译该 MEX 文件。

mex('-v',ipath,'matrixDivideComplex.c',fortfile,lapacklib)

通过使用 -L-l 选项指定 libmwlapack.lib 库,在 Windows 平台上编辑 matrixDivide.c 示例。库文件位于文件夹 matlabroot\extern\lib\arch\microsoft 中。

matrixDivide.c 示例复制到当前文件夹。

copyfile(fullfile(matlabroot,'extern','examples','refbook','matrixDivide.c'),'.','f')

捕获 matlabroot 的值。

matlabroot
ans =

C:\Program Files\MATLAB\R2014a

捕获 arch 的值。

computer('arch')
ans =

win64

要编译 MEX 文件,请将 matlabrootarch 的值复制到 mex 命令中,如以下语句所示。

mex '-LC:\Program Files\MATLAB\R2014a\extern\lib\win64\microsoft'...
   -llibmwlapack matrixDivide.c

您必须使用 ' 字符,这是因为路径中的 \Program Files 包括空格。

mxcreatecharmatrixfromstr.c 示例使用 #define 符号 SPACE_PADDING 来确定要在矩阵的字符向量之间使用的字符。要设置该值,请使用 -D 选项编译 MEX 文件。

将示例复制到当前文件夹。

copyfile(fullfile(matlabroot,'extern','examples','mx','mxcreatecharmatrixfromstr.c'),'.','f')

SPACE_PADDING 指令设置为在值之间添加空格。

mex mxcreatecharmatrixfromstr.c -DSPACE_PADDING
Building with 'MinGW64 Compiler  C '.
MEX completed successfully.

engwindemo.c 引擎示例复制到当前文件夹。

copyfile(fullfile(matlabroot,'extern','examples','eng_mat','engwindemo.c'),'.','f')
mex -client engine engwindemo.c

如果您在 Windows 平台上运行,则必须先将 MATLAB 注册为 COM 服务器。有关详细信息,请参阅Register MATLAB as a COM Server

运行示例。

!engwindemo
mex -setup

MATLAB 根据支持和兼容的编译器列表显示适用于您的版本和系统的选项。

输入参数

全部折叠

一个或多个文件名,包括名称和文件扩展名,指定为字符串或字符向量。如果文件不在当前文件夹中,请指定该文件的完整路径。

文件名可以是以下项的任意组合:

  • C、C++ 或 Fortran 语言源文件

  • Simulink® S 函数文件

  • 对象文件

  • 静态库文件。要链接动态库,请使用 -llibname 选项。

filenames 中列出的第一个源代码文件是该二进制 MEX 文件的名称。要覆盖此命名约定,请使用 '-output' 选项。

数据类型: char

一个或多个编译选项,指定为下列值之一。除非另有说明,否则选项可在任意平台上按任意顺序出现。

选项说明

@rspfile

使用 Windows RSP 文件。RSP 文件是包含命令行选项的文本文件。不支持非 ASCII 字符。

-c

仅编译对象文件。不要编译二进制 MEX 文件。

-client engine

编译引擎应用程序。

-compatibleArrayDims
-largeArrayDims(默认值)

与指定 MATLAB 数组处理 API 相链接。

  • -compatibleArrayDims - 使用 MATLAB 版本 7.2 数组处理 API,该 API 将数组限制为 231-1 个元素。仅适用于 C MEX S-Function 的默认选项。

  • -largeArrayDims - 使用 MATLAB 大型数组处理 API。此 API 处理元素数目超过 231-1 个的数组。调用 LAPACK 或 BLAS 函数时必须使用此选项。适用于 MEX 文件的默认选项。

-Dsymbolname
-Dsymbolname=symbolvalue
-Usymbolname

-D 选项定义 C 预处理器宏。等效于源文件中的以下符号:

  • #define symbolname

  • #define symbolname symbolvalue

-U 选项删除 C 预处理器宏 symbolname 的任何初始定义。-D 选项的反选。

不要在 DUsymbolname 之间添加空格。不要在 = 符号前后添加空格。

示例:定义编译器指令

-f filepath

要编译引擎应用程序,请使用 -client engine 选项。

指定 mex 配置文件的名称和位置。覆盖默认编译器选择。有关使用非默认编译器的信息,请参阅更改默认编译器filepath 是配置文件的名称和完整路径,指定为字符串或字符向量。

-g

添加符号信息,并禁止优化编译的对象代码。用于调试。要执行优化调试,请添加 -O 选项。

-h[elp]

显示 mex 的帮助。在操作系统提示符环境下使用。

-Ipathname

pathname 添加到文件夹列表以搜索 #include 文件。

不要在 Ipathname 之间添加空格。

示例:指定包含文件的路径

-llibname
-Llibfolder -llibname

libfolder(可选)中的动态对象库 libname 的链接。

MATLAB 将 libname 扩展为:

  • libname.libliblibname.lib - Windows 系统

  • liblibname.dylib - Mac 系统

  • liblibname.so - Linux 系统

如有使用,-L 选项必须位于 -l 选项之前。在 Linux 或 Mac 系统上使用 -L 选项时,您还必须设置运行时库路径,如中所述。

不要在 llibname 或者 Llibfolder 之间添加空格。

使用小写字母 L 指定 -l 选项。

要链接静态库,请使用 filenames 输入参数

示例:指定库文件的路径

-largeArrayDims
(默认值)
-compatibleArrayDims

与指定 MATLAB 数组处理 API 相链接。

  • -largeArrayDims - 使用 MATLAB 大型数组处理 API。此 API 处理元素数目超过 231-1 个的数组。调用 LAPACK 或 BLAS 函数时必须使用此选项。默认选项。

  • -compatibleArrayDims - 使用 MATLAB 版本 7.2 数组处理 API,该 API 将数组限制为 231-1 个元素。仅适用于 C MEX S-Function 的默认选项。

在详细模式(-v 选项)下,如果您不指定 -compatibleArrayDims-largeArrayDims 选项,MATLAB 将会显示一条指示默认选项的消息。

-n

显示但不执行命令,将由 mex 执行。

示例:预览编译命令

-O

优化对象代码。使用此选项执行优化编译。

默认情况下,优化处于启用状态。如果显示了 -g 选项,而没有显示 -O 选项,则优化会被禁用。

使用大写字母 O 指定此选项。

-outdir dirname

将所有输出文件放在文件夹 dirname 中。

示例:创建并链接到单独的对象文件

-output mexname

覆盖默认的 MEX 文件命名机制。创建具有相应 MEX 文件扩展名的名为 mexname 的二进制 MEX 文件。

示例:使用通配符组合源文件

-setup lang

更改用于编译 lang 语言 MEX 文件的默认编译器。当您使用此选项时,所有其他命令行选项都将被忽略。

-silent

隐藏信息性消息。即使您指定了 -silentmex 命令仍会报告错误和警告。

-Usymbolname

删除 C 预处理器宏 symbolname 的任何初始定义。(-D 选项的反选。)

不要在 Usymbolname 之间添加空格。

-v

在详细模式下编译。在考虑所有命令行参数后显示内部变量的值。显示每个编译步骤和链接步骤的详细计算信息。用于排查编译器设置问题。

示例:显示详细编译和故障排除信息

varname=varvalue

覆盖变量 varname 的默认设置。在考虑所有命令行参数后处理此选项。

示例:覆盖默认编译器开关选项

语言,指定为下列值之一。

C

C 编译器,包括 C++。

C++CPP

C++ 编译器。

Fortran

Fortran 编译器。

提示

  • 您可以从以下位置运行 mex

    • MATLAB 命令行窗口

    • Windows 系统提示符

    • Mac 终端

    • Linux Shell

    要在 MATLAB 之外使用命令行,请访问 [matlabroot '/bin'] 所指定文件夹中的 mex 程序。

  • MEX 文件具有与平台相关的扩展名。您可以将适用于不同平台的多个二进制 MEX 文件放在同一个文件夹中。

    MEX 文件与平台相关的扩展名

    平台二进制 MEX 文件扩展名

    Linux(64 位)

    mexa64

    Apple Mac(64 位)

    mexmaci64

    Windows(64 位)

    mexw64

    要标识 MEX 文件扩展名,请使用 mexext 函数。

  • 要使用 mex 为独立 MATLAB 引擎和 MAT 文件应用程序编译可执行文件,请使用 -client engine 选项。

  • mex 命令不支持包含双引号 (") 字符的文件夹名称。

在 R2006a 之前推出

此主题对您有帮助吗?