mxSetDoubles (C)

在 mxDOUBLE_CLASS 数组中的设置实数数据元素

全页展开

C 语法

#include "matrix.h"
int mxSetDoubles(mxArray *pa, mxDouble *dt);

描述

使用 mxSetDoubles 设置指定数组中的 mxDouble 数据。

所有 mxCreate* 函数都分配堆空间来保留数据。因此，通常不使用此函数来初始化数组的元素。而是调用该函数来用新值替换现有值。

输入参数

全部展开

指向 mxDOUBLE_CLASS 数组的指针。

指向数据数组的第一个 mxDouble 元素的指针。dt 必须由函数 mxCalloc 或 mxMalloc 分配。

输出参量

全部展开

函数状态，返回为 int。如果成功，则该函数返回 1。

如果 pa 为 NULL，则函数返回 0。

当 mxArray 不是非共享 mxDOUBLE_CLASS 数组时，或如果数据不是用 mxCalloc 分配的，则该函数不成功。如果该函数不成功，则：

  • MEX 文件 - 函数将终止 MEX 文件并将控制权返回给 MATLAB® 提示符。

  • 独立（非 MEX 文件）应用程序 - 函数将返回 0。

示例

请参阅 matlabroot/extern/examples/refbook 文件夹中的 arrayFillSetPr.c 示例。

API 版本

此函数在交错式复矩阵 API 中可用。要使用此函数编译 myMexFile.c，请键入：

mex -R2018a myMexFile.c

版本历史记录

在 R2018a 中推出

另请参阅

|