mxGetPr (C)

R2026b

（不推荐）mxDOUBLE_CLASS 数组中的实数数据元素

不推荐使用 mxGetPr。请改用 mxGetDoubles 或 mxGetComplexDoubles。有关详细信息，请参阅版本历史记录。

C 语法

#include "matrix.h"
mxDouble *mxGetPr(const mxArray *pm);

仅对类型为 mxDOUBLE_CLASS 的实数数组使用 mxGetPr。对于其他数值 mxArray 类型，使用 C MEX 函数中的类型化数据访问函数。对于复数数组，请参阅输出参量 dt 的描述。

调用 mxIsDouble 来验证 mxArray 类型。调用 mxIsComplex 来确定数据是否为实数。

指向类型为 mxDOUBLE_CLASS 的 MATLAB 数组的指针，指定为 mxArray *。

指向 mxArray 内数据数组的指针，指定为 mxDouble *。输出参量中的数据取决于您使用的 C Matrix API 版本：

如果您使用分离式复数 API（mex -R2017b 选项）进行编译，则函数返回指向数据实部的第一个 mxDouble 元素的指针。
如果您使用交错式复数 API（mex -R2018a 选项）进行编译且 pm 为复数，则函数将终止 MEX 文件并将控制权返回给 MATLAB 提示符。在非 MEX 文件应用程序中，函数返回 NULL。

如果 pm 为 NULL，则函数返回 NULL。

在 R2006a 之前推出

全部展开

在交错式复数 API 中使用 mxGetDoubles 函数来处理类型为 mxDOUBLE_CLASS 的实数输入数组。使用 mxGetComplexDoubles 来处理类型为 mxDOUBLE_CLASS 的复数输入数组。这些函数验证输入的类型和复/实性。

MathWorks 建议您使用交错式复数 API 中的定型数据访问函数来创建 MEX 文件和更新现有 MEX 文件。有关详细信息，请参阅：

要编译 MEX 文件，请使用 -R2018a 选项调用 mex。

使用 mxGetComplexDoubles 函数而不是 mxGetPr 和 mxGetPi。有关详细信息，请参阅 dt 输出参量。有关说明如何更新使用 mxGetPr 的代码的示例，请参阅 convec.c。