墨西哥人

构建MEX功能或引擎应用程序

折叠所有页面

语法

墨西哥人文件名

Mex filenames API option1…optionN

Mex -客户端引擎文件名

Mex -客户端引擎文件名API选项1…optionN

墨西哥人设置(朗)

设置客户端引擎

描述

例子

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

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

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

例子

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

墨西哥人客户端引擎文件名编译c++源文件MATLAB数据API进入独立的MATLAB引擎应用程序。有关更多信息，请参见c++引擎API简介

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

墨西哥人客户端引擎文件名apioption1……optionN使用指定的api和可选的option1……optionN参数。

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

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

例子

全部折叠

使用交错复杂API构建MEX文件

的源代码示例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 MEX文件

打开生活的脚本

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

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

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

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

墨西哥人yprime.c

使用“MinGW64 Compiler (C)”编译。墨西哥人成功完成。

测试。

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

ans =1×42.000 8.9685 4.0000 -1.0947

显示详细的构建和故障排除信息

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

墨西哥人- 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提示下，使用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文件

打开脚本

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

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

拷贝文件(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 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编译器。金宝app将计算子例程复制到当前文件夹。

拷贝文件(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使用- 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确定在矩阵中的字符向量之间使用哪个字符。要设置该值，使用- 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”）

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

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

运行示例。

engwindemo !

选择C编译器

墨西哥人设置

MATLAB根据列表显示您的版本和系统的选项金宝app支持和兼容编译器．

链接命令选项

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

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

输入参数

全部折叠

`文件名`- - - - - -一个或多个文件名
字符串|特征向量

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

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

C、c++或Fortran语言的源文件
金宝app^®函数文件
对象文件
静态库文件。文件名必须包含库文件的完全限定路径。要链接动态库，请使用- l库名选择。

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

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

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

数据类型:字符

`api`- - - - - -释放特定API
`-R2017b`(默认)|`-R2018a`|`-largeArrayDims`|`-compatibleArrayDims`

与特定发行版的链接矩阵C API或Fortran矩阵API，指定为其中一个值。不要组合这些选项。

不要对MEX文件或使用MATLAB数据API．

API	描述
`-R2017b`(默认)	构建: 分离复杂的API，它包含了MATLAB R2017b和更早的C和Fortran矩阵API功能。大数组处理API，用于处理超过2个的数组³¹1的元素。将图形对象的句柄视为`对象`,而不是`双`．在MATLAB的未来版本，默认`api`选项将更改为使用交错复杂API (`-R2018a`）.MathWorks建议您创建应用程序并更新现有应用程序以使用交错的复杂API。另外,使用`MX_HAS_INTERLEAVED_COMPLEX`宏以确保跨MATLAB版本的所需行为。有关更多信息，请参见支持MEX函数金宝app中交错的复杂API．
`-R2018a`	构建: 交错复杂API，其中包括类型的数据访问功能。有关更多信息，请参见升级MEX文件以使用交错复杂API． Large-array-handling API 将图形对象的句柄视为`对象`,而不是`双`．要运行用MATLAB R2018a中交错复杂API构建的Fortran MEX文件，必须使用MATLAB R2018a Update 3。
`-largeArrayDims`	构建: 单独的复杂的API Large-array-handling API 将图形对象的句柄视为`对象`,而不是`双`．将句柄视为`双`，将此选项与`-DMEX_DOUBLE_HANDLE`．
`-compatibleArrayDims`	构建: 单独的复杂的API 版本7.2数组处理API，将数组限制为2³¹1的元素将图形对象的句柄视为`对象`,而不是`双`．将句柄视为`双`，将此选项与`-DMEX_DOUBLE_HANDLE`．请勿使用`-compatibleArrayDims`选择的时候调用LAPACK或BLAS函数．仅用于C MEX s -函数的默认选项。

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

`option1……optionN`- - - - - -可选的构建选项
与有效选项标志对应的字符串或字符向量

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

选项	描述
`＠rspfile`	使用Windows RSP文件。RSP文件是包含命令行选项的文本文件。不支持非ascii字符。金宝app
`- c`	只编译一个对象文件。不构建二进制MEX文件。
`客户端引擎`	构建应用程序引擎。
`- dsymbolname` `- dsymbolname＝symbolvalue` `- usymbolname`	的`- d`选项定义C预处理器宏。等价于源文件中的以下内容: `#定义``symbolname` `#定义``symbolname``symbolvalue` 的`- 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`在Linux或macOS系统中，您还必须设置运行时库路径，如设置运行库路径．中间不加空格l和`库名`之间或l和`libfolder`．指定`- l`选项的小写字母l．要链接静态库，请使用`文件名`输入参数．例子:指定库文件路径
`- n`	显示但不执行命令`墨西哥人`将执行。例子:预览构建命令
`- o`	优化目标代码。使用此选项可进行优化编译。默认情况下，优化是启用的。用大写字母指定该选项O．
`-outdir目录名`	将所有输出文件放在文件夹中`目录名`．例子:创建并链接到独立的对象文件
`与产出mexname`	覆盖默认的MEX文件命名机制。创建名为`mexname`使用适当的MEX文件扩展名。例子:使用通配符组合源文件
`设置朗`	将默认编译器更改为build`朗`语言MEX文件或引擎应用程序。当你使用这个选项时，`墨西哥人`忽略所有其他命令行选项。
`沉默`	抑制信息性消息。的`墨西哥人`命令仍然报告错误和警告，即使您指定`沉默`．
`- usymbolname`	删除C预处理器宏的任何初始定义`symbolname`．(逆`- d`选择。）中间不加空格U和`symbolname`．
`- v`	以详细模式构建。在考虑所有命令行参数后显示内部变量的值。显示每个编译和链接步骤的全部计算结果。用于排除编译器设置问题。例子:显示详细的构建和故障排除信息
`varname＝varvalue`	将值附加到环境变量`varname`．该选项在考虑所有命令行参数后进行处理。例子:附加的编译器选项覆盖默认编译器开关选项

`朗`- - - - - -语言
`C`(默认)|`c++`|`CPP`|`Fortran`

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

`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引擎应用程序构建可执行文件，使用客户端引擎选择。
的墨西哥人命令不支持包含双引号的文件夹名(金宝app＂)字符。

之前介绍过的R2006a

墨西哥人

语法

描述

例子

使用交错复杂API构建MEX文件

构建C MEX文件

显示详细的构建和故障排除信息

附加的编译器选项

覆盖默认编译器开关选项

从多个源文件构建MEX文件

使用通配符组合源文件

预览构建命令

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

指定包含文件的路径

指定库文件路径

定义编译器指令

构建应用程序引擎

选择C编译器

链接命令选项

输入参数

`文件名`- - - - - -一个或多个文件名
字符串|特征向量

`api`- - - - - -释放特定API
`-R2017b`(默认)|`-R2018a`|`-largeArrayDims`|`-compatibleArrayDims`

`option1……optionN`- - - - - -可选的构建选项
与有效选项标志对应的字符串或字符向量

`朗`- - - - - -语言
`C`(默认)|`c++`|`CPP`|`Fortran`

提示

另请参阅

主题

外部网站

MATLAB的文档

金宝app

介绍基于MATLAB的深度学习

墨西哥人

语法

描述

例子

使用交错复杂API构建MEX文件

构建C MEX文件

显示详细的构建和故障排除信息

附加的编译器选项

覆盖默认编译器开关选项

从多个源文件构建MEX文件

使用通配符组合源文件

预览构建命令

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

指定包含文件的路径

指定库文件路径

定义编译器指令

构建应用程序引擎

选择C编译器

链接命令选项

输入参数

文件名- - - - - -一个或多个文件名字符串|特征向量

api- - - - - -释放特定API-R2017b(默认)|-R2018a|-largeArrayDims|-compatibleArrayDims

option1……optionN- - - - - -可选的构建选项与有效选项标志对应的字符串或字符向量

朗- - - - - -语言C(默认)|c++|CPP|Fortran

提示

另请参阅

主题

外部网站

MATLAB的文档

金宝app

介绍基于MATLAB的深度学习

`文件名`- - - - - -一个或多个文件名
字符串|特征向量

`api`- - - - - -释放特定API
`-R2017b`(默认)|`-R2018a`|`-largeArrayDims`|`-compatibleArrayDims`

`option1……optionN`- - - - - -可选的构建选项
与有效选项标志对应的字符串或字符向量

`朗`- - - - - -语言
`C`(默认)|`c++`|`CPP`|`Fortran`