mxCreateSparse (C和Fortran)
二维稀疏阵列
C语法
#包括“矩阵。h”mxArray * mxCreateSparse (mwSize m, mwSize n, mwSize nzmax, mxComplexity ComplexFlag);
Fortran语言的语法
# include“fintrf。h”mwPointer mxCreateSparse (m, n, nzmax ComplexFlag) mwSize m, n, * 4 ComplexFlag nzmax整数
参数
-
米 -
的行数
-
n -
列数
-
nzmax -
的元素数量
mxCreateSparse应该分配的公关,红外,如果ComplexFlag是mxCOMPLEX在C (1在Fortran),π数组。设定的值nzmax大于或等于非零元素的数量你打算投入的mxArray,但确保nzmax小于或等于什么m * n。nzmax大于或等于1。 -
ComplexFlag -
如果
mxArray要创建包含虚拟数据,设置ComplexFlag来mxCOMPLEX在C (1在Fortran)。否则,设置ComplexFlag来mxREAL在C (0在Fortran)。
返回
指针创建的mxArray。如果不成功的在一个独立的(non-MEX文件)应用程序中,回报零在C (0在Fortran)。如果在墨西哥人文件失败,墨西哥人对MATLAB文件终止并返回控制®提示。函数失败当没有足够的自由堆空间来创建mxArray。在这种情况下,尽量减少nzmax,米,或n。
描述
调用mxCreateSparse创建一个无人居住的稀疏的翻倍mxArray。返回的稀疏mxArray不含稀疏信息,不能作为参数传递给任何MATLAB稀疏的功能。返回的稀疏mxArray有用的,初始化公关,红外,jc,(如果它存在的话)π数组。
mxCreateSparse分配的空间:
一个
公关数组的长度nzmax。一个
π数组的长度nzmax,但前提是ComplexFlag是mxCOMPLEX在C (1在Fortran)。一个
红外数组的长度nzmax。一个
jc数组的长度n + 1。
当你完成使用稀疏mxArray,叫mxDestroyArray收回所有的堆空间。
版本历史
之前介绍过的R2006a
