主要内容

墨西哥人

构建MEX函数或引擎应用程序

在页面中全部折叠

语法

墨西哥人文件名
Mex文件名API option1…optionN
Mex -客户端引擎文件名
Mex客户端引擎文件名API option1…optionN
墨西哥人设置(朗)
Mex -setup -client engine [lang]

描述

例子

墨西哥人文件名类编写的一个或多个c++源文件MATLAB数据API为c++到当前文件夹中的一个二进制MEX文件中。有关编写这些应用程序的信息，请参见编写MATLAB中可调用的c++函数(MEX文件)．

如果编写MEX文件基于矩阵C API或者是Fortran矩阵API,然后墨西哥人文件名编译一个或多个C、c++或Fortran源文件-R2017bapi．在未来版本的MATLAB中®,默认的api选项将更改为使用交错复杂API (-R2018a)．MathWorks建议您创建MEX文件并更新现有的MEX文件，以使用交错的复杂API。另外,使用MX_HAS_INTERLEAVED_COMPLEX宏应用所需的行为跨版本的MATLAB。有关更多信息，请参见MATLAB支持MEX函数中交错复杂API．

有关使用C、c++和Fortran应用程序的信息，请参见将MATLAB与外部编程语言和系统集成．

例子

墨西哥人文件名apioption1……optionN使用指定的api和可选的option1……optionN参数。的option1……optionN实参补充或覆盖默认值墨西哥人构建配置。

墨西哥人客户端引擎文件名类编写的c++源文件MATLAB数据API为c++变成独立的MATLAB引擎应用程序。有关更多信息，请参见c++引擎程序的元素．

如果编写应用程序基于MATLAB引擎API for C,C MAT-File API,Fortran引擎API,或者是Fortran MAT-File API,然后墨西哥人客户端引擎文件名方法构建独立应用程序-R2017bapi．在MATLAB的未来版本中，默认的api选项将更改为使用交错复杂API (-R2018a)．MathWorks建议您创建引擎应用程序并更新现有的应用程序以使用交错的复杂API。

墨西哥人客户端引擎文件名apioption1……optionN创建引擎应用程序api和可选的option1……optionN参数。

墨西哥人设置(朗］显示有关用于构建MEX文件的给定语言的默认编译器的信息。MATLAB为每种支持的语言都定义了一个默认编译器。如果对给定的语言有多个编译器，请使用朗选项更改该语言的默认编译器。有关更多信息，请参见改变默认的编译器而且选择c++编译器．

Mex -setup -client engine [朗］选择用于构建引擎应用程序的编译器。

例子

全部折叠

文件中复制源代码示例matlabroot/外面的例子文件夹中。

拷贝文件(fullfile (matlabroot,“外来的”，“例子”，墨西哥人的，“explore.c”)，“。”，“f”）

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

墨西哥人-R2018aexplore.c

通过传递复杂矩阵来测试函数。

A = [1 3 5];B = [5 3 1];一个=复杂(A, b);探索(A)
------------------------------------------------ 名称:prhs[0]维度:1 x3类名:双  ------------------------------------------------ ( 1, - 1) = 1 + 5(1、2)= 3 + 3(1、3)= 5 + 1我
打开生活的脚本

构建一个C程序yprime.c到MEX文件中。

文件中复制源代码示例matlabroot/外面的例子文件夹中。

拷贝文件(fullfile (matlabroot,“外来的”，“例子”，墨西哥人的，“yprime.c”)，“。”，“f”）

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

墨西哥人yprime.c
使用“MinGW64编译器(C)”编译。墨西哥人成功完成。

测试。

T = 1;Y = 1:4;yprime (T, Y)
ans =1×42.000 8.9685 4.0000 -1.0947

若要显示编译和链接命令以及对故障排除有用的其他信息，请使用verbose模式。输出显示特定于您的平台和编译器的信息。

墨西哥人- v-compatibleArrayDimsyprime.c

使用环境变量指定要传递给编译器的其他选项。

确定变量名:

  • 用于用MinGW构建c++代码®，macOS和Linux®编译器,使用CXXFLAGS．

  • 对于使用MinGW构建C代码，macOS，和Linux编译器，使用CFLAGS．

  • 与微软®Visual Studio®编译器,使用COMPFLAGS．

在使用Visual Studio构建MEX文件时指定c++ 17标准。

墨西哥人COMPFLAGS = '美元COMPFLAGS化= c++ 17 'yprime.c

有关在不同平台上使用字符串分隔符的更多信息，请参见覆盖默认编译器开关选项．

构建yprime.c通过附加值来添加MEX文件- wall添加到现有的编译器标志。因为该值包含一个空格字符，所以必须限定字符串;你使用的角色取决于平台。

在MATLAB提示下，使用单引号(＇)．

墨西哥人- vCOMPFLAGS = ' $ - wall COMPFLAGS 'yprime.c

对于基于gcc/g++的MinGW-w64编译器，使用Linux编译器标志。选择以下命令之一:

墨西哥人- vCXXFLAGS = ' $ - wall CXXFLAGS 'yprime.c% c++编译器墨西哥人- vCFLAGS = ' $ CFLAGS - wall’yprime.c% C编译器

在窗户®命令提示符，使用双引号(＂)．

墨西哥人- vCOMPFLAGS = " COMPFLAGS美元- wall”yprime.c

在shell命令行上macOS在Linux中，使用单引号(＇)．

墨西哥人- vCFLAGS = ' $ CFLAGS - wall’yprime.c
打开脚本

MEX文件示例fulltosparse包含两个Fortran源文件，loadsparse。F而且fulltosparse。F．要运行此示例，您需要在系统上安装一个受支持的Fortran编译器。

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

拷贝文件(fullfile (matlabroot,“外来的”，“例子”，“refbook”，“loadsparse。F ')，“。”，“f”)复制文件(fullfile (matlabroot,“外来的”，“例子”，“refbook”，“fulltosparse。F ')，“。”，“f”）

构建fulltosparse墨西哥人文件。MEX文件名为fulltosparse因为fulltosparse。F是命令行中的第一个文件。输出包含特定于编译器的信息。

墨西哥人-largeArrayDimsfulltosparse。Floadsparse。F
使用“Intel Visual Fortran Composer XE 2013 with Microsoft Visual Studio 2012”构建。墨西哥人成功完成。

测试。

完整的眼睛= (5);晶石= fulltosparse(全)
SPAR = 1,1,1,2,2,1,1,3,3,1,4,4,1,5,5,1

将当前文件夹中的所有C源文件合并到MEX文件中mymex．使用与产出选项来控制MEX文件的名称。

墨西哥人与产出mymex* . c

要在不执行命令的情况下预览构建命令的详细信息，请使用- n选择。输出显示特定于您的平台和编译器的信息。

墨西哥人- nyprime.c
打开脚本

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

MEX文件示例fulltosparse包含两个Fortran源文件。的fulltosparse文件是网关例程(包含mexFunction子例程),loadsparse包含计算例程。

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

拷贝文件(fullfile (matlabroot,“外来的”，“例子”，“refbook”，“loadsparse。F ')，“。”，“f”）

编译子例程并将目标文件放在单独的文件夹中，c: \ objfiles．

mkdirc: \ objfiles墨西哥人-largeArrayDims- c-outdirc: \ objfilesloadsparse。F
使用“Intel Visual Fortran Composer XE 2013 with Microsoft Visual Studio 2012”构建。墨西哥人成功完成。

将网关子例程复制到当前文件夹。编译并链接到loadsparse对象文件。

拷贝文件(fullfile (matlabroot,“外来的”，“例子”，“refbook”，“fulltosparse。F ')，“。”，“f”)墨西哥人-largeArrayDimsfulltosparse。Fc: \ objfiles \ loadsparse.obj
使用“Intel Visual Fortran Composer XE 2013 with Microsoft Visual Studio 2012”构建。墨西哥人成功完成。

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

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

拷贝文件(fullfile (matlabroot,“外来的”，“例子”，“refbook”，“matrixDivideComplex.c”)，“。”，“f”）

创建-我参数的连接“我”与路径fort.h文件。

ipath = [“我”fullfile (matlabroot“外来的”，“例子”，“refbook”));

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

lapacklib = fullfile (matlabroot,“外来的”，“自由”、计算机(“拱”)，“微软”，“libmwlapack.lib”）;fortfile = fullfile (matlabroot,“外来的”，“例子”，“refbook”，“fort.c”）;

构建MEX文件。

墨西哥人(“v”，“-R2017b”ipath,“matrixDivideComplex.c”、fortfile lapacklib)

构建matrixDivide.c实例在Windows平台上使用- l而且- l选项来指定libmwlapack.lib图书馆。库文件位于文件夹中matlabrootextern \ \ lib \拱微软\．

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

拷贝文件(fullfile (matlabroot,“外来的”，“例子”，“refbook”，“matrixDivide.c”)，“。”，“f”）

捕获的值matlabroot中使用的语句显示墨西哥人命令。

matlabroot
ans = C:\Program Files\MATLAB\R2014a

捕获的值拱中使用的语句显示墨西哥人命令。

计算机(“拱”）
ans = win64

要构建MEX文件，请复制的值matlabroot而且拱到墨西哥人命令。

墨西哥人lc: \ MATLAB程序文件\ \ R2014a \走读生\ lib \ win64 \微软的.．.-llibmwlapackmatrixDivide.c

你必须使用＇字符,因为\程序文件在路径中包含一个空格。

打开脚本

的mxcreatecharmatrixfromstr.c示例使用一个#定义象征SPACE_PADDING确定在矩阵中的字符向量之间使用什么字符。方法构建MEX文件以设置该值- d选择。

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

拷贝文件(fullfile (matlabroot,“外来的”，“例子”，“mx”，“mxcreatecharmatrixfromstr.c”)，“。”，“f”）

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

墨西哥人mxcreatecharmatrixfromstr.c-DSPACE_PADDING
使用“MinGW64 Compiler C”编译。墨西哥人成功完成。

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

拷贝文件(fullfile (matlabroot,“外来的”，“例子”，“eng_mat”，“engwindemo.c”)，“。”，“f”）

构建一个独立的MATLAB引擎应用程序客户端引擎语法。

墨西哥人客户端引擎engwindemo.c

如果您在Windows平台上运行，则必须首先将MATLAB注册为COM服务器。有关更多信息，请参见将MATLAB注册为COM服务器．

运行示例。

engwindemo !
墨西哥人设置

的列表为您的版本和系统显示选项支持和兼容的编译器．

来添加选项墨西哥人Link命令，使用LINKFLAGS命令行选项。例如，在构建时指定可执行文件的环境mymex.c在Windows上,类型:

墨西哥人- vLINKFLAGS = ' $ LINKFLAGS /子系统:windows 'mymex.c

输入参数

全部折叠

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

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

  • C、c++或Fortran源文件

  • 动态仿真模块®函数文件

  • 对象文件

  • 静态库文件。文件名必须包含库文件的完全限定路径。要链接动态库，请使用- l库名选择。

中的第一个源代码文件文件名是二进制MEX文件或引擎应用程序的名称。要覆盖此命名约定，请使用与产出选择。

使用MATLAB编辑器来编写源代码。如果您使用集成开发环境(IDE)，例如微软Visual Studio或Xcode，然后您可以使用墨西哥人命令或遵循指导方针使用MEX脚本选项自定义构建．

MATLAB自动选择编译器，如果安装，基于语言文件名参数。

与特定于发行版的链接矩阵C API或Fortran矩阵API，指定为表中的值之一。不要将这些选项组合在一起。

不要将此选项用于使用MATLAB数据API为c++．

API 描述

-R2017b(默认)

构建:

  • 独立的复杂API，它包含了MATLAB R2017b和更早版本中的C和Fortran矩阵API功能。

  • 大数组处理API，它处理超过2个的数组311的元素。

  • 将图形对象的句柄处理为对象,而不是双．

在MATLAB的未来版本中，默认的api选项将更改为使用交错复杂API (-R2018a)．MathWorks建议您创建应用程序并更新现有的应用程序，以使用交错的复杂API。另外,使用MX_HAS_INTERLEAVED_COMPLEX宏应用所需的行为跨版本的MATLAB。有关更多信息，请参见MATLAB支持MEX函数中交错复杂API．
-R2018a

构建:

要运行R2018a中使用交错复杂API构建的Fortran MEX文件，必须使用R2018a Update 3。
-largeArrayDims

构建:

  • 单独的复杂的API

  • Large-array-handling API

  • 将图形对象的句柄处理为对象,而不是双．把把手当作双，将此选项与-DMEX_DOUBLE_HANDLE．
-compatibleArrayDims

构建:

  • 单独的复杂的API

  • 版本7.2数组处理API，它将数组限制为2个311的元素

  • 将图形对象的句柄处理为对象,而不是双．把把手当作双，将此选项与-DMEX_DOUBLE_HANDLE．

请勿使用-compatibleArrayDims选择的时候调用LAPACK或BLAS函数．

C MEX S-functions的默认选项。

例子:墨西哥人-R2018a explore.c

可选构建选项，指定为此表中的值之一。选项可以在任何平台上以任何顺序出现，除非有指示。

选项 描述

@rspfile

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

- c

只编译一个目标文件。不构建二进制MEX文件。

客户端引擎

构建引擎应用程序。

- dsymbolname
- dsymbolname＝symbolvalue
- usymbolname

的- doptions定义C预处理器宏。相当于源文件中的如下内容:

  • #定义symbolname

  • #定义symbolnamesymbolvalue

的- u选项删除C预处理器宏的任何初始定义，symbolname．逆的- d选择。

不要在中间加空格D或U而且symbolname．不要在＝的迹象。

例子:定义编译器指令

- ffilepath

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

请勿使用- f选项来构建引擎应用程序。使用客户端引擎选项。

- g

添加符号信息并禁用优化构建的目标代码。用于调试。

- h (elp)

显示帮助墨西哥人．从操作系统提示符使用。

-我路径名

增加了路径名添加到要搜索的文件夹列表# include文件。

不要在中间加空格我而且路径名．

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

- l库名
- llibfolder- l库名

带有动态对象库的链接库名(可选)libfolder．

MATLAB的扩张库名:

  • 库名. lib或自由库名. lib——Windows系统

  • 自由库名. dylib- - - - - -macOS系统

  • 自由库名所以——Linux系统

如果使用,- l选项必须在- l选择。当使用- l选项或macOS系统中，您还必须设置运行时库路径，如中所述设置运行时库路径．

指定- l选项中包含小写字母l．不要在中间加空格l而且库名之间或l而且libfolder．

要链接静态库，请使用文件名输入参数。

例子:指定库文件的路径

- n

显示但不执行命令墨西哥人将执行。

例子:预览构建命令

- o

优化目标代码。使用此选项进行优化编译。优化在默认情况下是启用的。

用大写字母指定此选项O．

-outdir目录名

将所有输出文件放入文件夹中目录名．

例子:创建并链接到独立的对象文件

与产出mexname

覆盖默认的MEX文件命名机制。创建一个名为mexname使用适当的MEX文件扩展名。

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

设置朗

更改要构建的默认编译器朗语言MEX文件或引擎应用程序。当您使用此选项时，墨西哥人忽略所有其他命令行选项。

沉默

抑制信息性消息。的墨西哥人命令在指定时仍然报告错误和警告沉默．

- usymbolname

删除C预处理器宏的任何初始定义symbolname．(逆- d选择。）

不要在中间加空格U而且symbolname．

- v

在详细模式下构建。在考虑了所有命令行参数之后，显示内部变量的值。显示每个编译和链接步骤的完整计算结果。用于排除编译器设置问题。

例子:显示详细的生成和故障排除信息

varname＝varvalue

向环境变量添加值varname．在考虑所有命令行参数后处理此选项。

例子:

语言，指定为这些不区分大小写的值之一。

C

C编译器，包括c++
c++或CPP

c++编译器
Fortran

Fortran编译器

提示

  • 您可以运行墨西哥人来自:

    • MATLAB命令窗口

    • Windows系统提示

    • macOS终端

    • Linux shell

    对于MATLAB之外的命令行用法，墨西哥人程序位于指定的文件夹中[matlabroot ' / bin ']在UNIX和[matlabroot ' \ bin \ win64 ']在Windows上。

  • MEX文件具有与平台相关的扩展名。您可以将不同平台的二进制MEX文件放在同一个文件夹中。要标识MEX文件扩展名，请使用mexext函数。

    MEX文件平台相关扩展

    平台 二进制MEX文件扩展名

    Linux(64位)

    mexa64

    苹果Mac(64位)

    mexmaci64

    Windows(64位)

    mexw64

  • 使用墨西哥人为独立的MATLAB引擎应用程序构建可执行文件，使用客户端引擎选择。

  • 的墨西哥人命令不支持包含双引号(＂)字符。

版本历史

之前介绍过的R2006a

全部展开

另请参阅

|||

主题

Baidu
map