matlab 建立 调用 函数库,Matlab调用外部库函数步骤和注意事项

当前位置:我的异常网» 编程 » Matlab调用外部库函数步骤和注意事项

Matlab调用外部库函数步骤和注意事项

www.myexceptions.net  网友分享于：2015-05-26  浏览：0次

Matlab调用外部库函数方法和注意事项

在MATLAB环境下访问外部函数的共享库文件，必须首先把该库文件加载到内存中。一旦加载成功，就

能直接在MATLAB中直接请求关于函数的任何信息。而当不再需要该库时，就应当及时把库文件从内存

中卸载以节省内存开销。

加载库

加载库加载库

加载库

语法：loadlibrary(‘shrlib’,’hfile’)

其中shrlib为加载的动态链接库文件名(filename.dll)，hfile为头文件名，它包含函数原型。例如，当加载包

含MATLAB中mx程序的libmx库时，可以使用下列语句。

hfile=[matlabroot’\extern\include\matrix.h’];

loadlibray(‘libmx’, hfile)

卸载库

卸载库卸载库

卸载库

语法：unloadlibrary libmx

使用两个函数可以获取加载库的信息：

libfunctions(‘libname’)   or libfunctions libname

libfunctionsview(‘libname’)   or libfunctionsview  libname

这两个函数的不同之处在于显示结果的方式不同，后者是以图形的方式显示在新的窗口中。而前者返回库

libmx中有哪些可用的函数。请看示例：

libfunctions libmx

Methods for class lib.libmx:

mxAddField                mxGetFieldNumber   mxIsLogicalScalarTrue

mxArrayToString           mxGetImagData      mxIsNaN

mxCalcSingleSubscript      mxGetInf           mxIsNumeric

mxCalloc                  mxGetIr            mxIsObject

mxClearScalarDoubleFlag    mxGetJc            mxIsOpaque

mxCreateCellArray          mxGetLogicals      mxIsScalarDoubleFlagSet

如果加上命令开头-full，则可以显示函数返回值的细节。

libfunctions libmx -full

Methods for class lib.libmx:

[mxClassID, MATLAB array] mxGetClassID(MATLAB array)

[lib.pointer, MATLAB array] mxGetData(MATLAB array)

[MATLAB array, voidPtr] mxSetData(MATLAB array, voidPtr)

[lib.pointer, MATLAB array] mxGetPr(MATLAB array)

[MATLAB array, doublePtr] mxSetPr(MATLAB array, doublePtr)

uint8 mxIsFinite(double)

uint8 mxIsInf(double)

值得注意的是，这两个函数返回值的类型均是MATLAB的数据类型，虽然函数是利用C语言编写的。

调用库函数

调用库函数调用库函数

调用库函数

一旦库函数被加载到了内存空间，只要指定库名、函数名和变量就可以使用calllib函数调用库中的任何函

数了。语法格式：

calllib(‘libname’,’funcname’,arg1,…,argn)

下列语句显示如何操作：

hfile=['C:\MATLAB7\extern\include\matrix.h']; loadlibrary(‘libmx’,hfile);

y=rand(4,7,2);  %produce a 3D array, there are 56 elements in it

calllib(‘libmx’,’mxGetNumberOfElements’,y)

ans=

56

Calllib(‘libmx’,’mxGetClassID’,y)

ans=

mxDouble_CLASS

传递变量

传递变量传递变量

传递变量

当调用外部库里的函数时，该为函数提供哪种类型的变量呢？MATLAB的

extern\examples\shrlib\shrlibsample库里对每一种特殊的变量类型都作出了说明。但我们首先必须把该库文

件的路径添加到MATLAB的搜索路径中来，或者使该库文件所在的目录成为当前目录，两种做法的命令

如下。

addpath(‘C:\MATLAB7\extern\examples\shrlib’)

cd(‘C:\MATLAB7\extern\examples\shrlib’)

下面的例子就是加载该库并显示了其中的一些函数。

loadlibrary shrlibsample shrlibsample.h

libfunctions shrlibsample –full

执行上述两行后，返回：

Functions in library shrlibsample:

[double, doublePtr] addDoubleRef(double, doublePtr, double)

double addMixedTypes(int16, int32, double)

[double, c_structPtr] addStructByRef(c_structPtr)

double addStructFields(c_struct)

c_structPtrPtr allocateStruct(c_structPtrPtr)

voidPtr deallocateStruct(voidPtr)

doublePtr multDoubleArray(doublePtr, int32)

[lib.pointer, doublePtr] multDoubleRef(doublePtr)

int16Ptr multiplyShort(int16Ptr, int32)

string readEnum(Enum1)

[string, string] stringToUpper(string)

这里所有的函数都是用C语言编写的。

一些通用的规则

一些通用的规则一些通用的规则

一些通用的规则

在函数的输入输出变量问题上，以下几点应注意：

1.许多变量类型，象int32、double与C语言的数据类型非常相象。这些变量只需要传递MATLAB型的数

据就可以了。

2.而有些C语言的变量类型，象**double、还有预定义型与标准MATLAB数据类型是完全不同的。这种情