mxSetPi (C)

Установите элементы мнимых данных в массиве mxDOUBLE_CLASS

mxSetPi не рекомендуется для приложений C и не доступен в Чередованном Комплексном API. Используйте mxSetComplexDoubles вместо mxSetPr и mxSetPi. Для получения дополнительной информации смотрите Введенный Доступ к данным.

Синтаксис C

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

Описание

Используйте mxSetPi, чтобы установить мнимые данные заданного mxArray.

Большая часть mxCreate* функции опционально выделяет пространство "кучи", чтобы содержать мнимые данные. Если вы выделяете пространство "кучи" при вызове mxCreate* функция — например, путем установки ComplexFlag на mxCOMPLEX или установкой pi к non-NULL значению — вы обычно не используете mxSetPi, чтобы инициализировать мнимые элементы массива. Скорее вы вызываете эту функцию, чтобы заменить существующие значения на новые значения.

Эта функция не освобождает памяти, выделенной для существующих данных, которые это перемещает. Чтобы освободить существующую память, вызовите mxFree на указателе, возвращенном mxGetPi.

Входные параметры

развернуть все

Указатель на массив mxDOUBLE_CLASS.

Указатель на первый элемент массива. Каждый элемент в массиве содержит мнимый компонент значения.

Массив должен быть в динамической памяти; вызовите mxCalloc, чтобы выделить эту память. Не используйте функцию ANSI® C calloc, которая может вызвать продвижение проблем выравнивания памяти к завершению программы. Если pi указывает на статическое ЗУ, то утечки памяти и другие ошибки памяти могут закончиться.

Версия API

Эта функция только доступна в отдельном комплексном API. Чтобы создать myMexFile.c с помощью этой функции, введите:

mex -R2017b myMexFile.c

MathWorks рекомендует, чтобы вы обновили свой файл MEX, чтобы использовать Введенные функции Доступа к данным вместо этого.

Представлено до R2006a

Была ли эта тема полезной?