mxSetPi (C)

(不推荐)设置虚数据元素mxDOUBLE_CLASS数组

全部展开页面

mxSetPi在交错的复杂API中不可用。使用mxSetComplexDoubles代替。有关更多信息，请参见兼容性的考虑．

C语法

#include "matrix.h" void mxSetPi(mxArray *pm, double *pi);

描述

使用mxSetPi设置指定的虚数据mxArray．

大多数mxCreate函数可以选择分配堆空间来保存虚拟数据。如果在调用时分配堆空间mxCreate*函数，则不使用mxSetPi初始化数组中的虚元素。相反，调用此函数以新值替换现有值。分配堆空间的示例包括设置ComplexFlag来mxCOMPLEX或设置π一个非零价值。

的mxSetPi函数不会释放为其替换的现有数据分配的任何内存。要释放现有内存，调用mxFree返回的指针上mxGetPi．

输入参数

全部展开

`点`- MATLAB指针^®数组
`mxArray *`

类型为MATLAB数组的指针mxDOUBLE_CLASS,指定为mxArray *．

`π`-指向数据数组的指针
`双*`

指向第一个mxDouble类中数据数组的虚部的元素mxArray,指定为双*．数组中的每个元素都包含一个值的虚分量。

数组必须在动态内存中。调用mxCalloc来分配这些内存。请勿使用ANSI^®Ccalloc函数，该函数可能导致内存对齐问题，从而导致程序终止。如果π指向静态内存，则可能导致内存泄漏和其他内存错误。

兼容性的考虑

全部展开

不使用单独的复杂API

不建议从R2018a开始

使用mxSetComplexDoubles函数，而不是mxSetPr和mxSetPi．此函数验证输入数组是否复杂且具有类型mxDOUBLE_CLASS．

MathWorks建议您创建MEX文件并更新现有的MEX文件，以便在交错的复杂API中使用有类型的数据访问函数。有关更多信息，请参见:

要构建MEX文件，调用墨西哥人与-R2018a选择。

错误的建筑`mxSetPi`与交错的复杂API

错误开始在R2018a

的mxSetPi函数仅在单独的复杂的API．构建myMexFile.c使用此函数，键入:

墨西哥人-R2017bmyMexFile.c

使用此函数构建的现有MEX文件将继续运行。

另请参阅

mxSetComplexDoubles

主题

之前介绍过的R2006a

mxSetPi (C)

C语法

描述