exponenta event banner

mxSetComplexSingles (C)

Установка сложных элементов данных в mxSINGLE_CLASS множество

Синтаксис C

#include "matrix.h"
int mxSetComplexSingles(mxArray *pa, mxComplexSingle *dt);

Описание

Использовать mxSetComplexSingles установить mxComplexSingle данные в указанном массиве.

Все mxCreate* функции выделяют кучное пространство для хранения данных. Поэтому эта функция обычно не используется для инициализации элементов массива. Вместо этого вызовите функцию для замены существующих значений новыми.

Входные аргументы

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

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

Указатель на первый mxComplexSingle элемент массива данных. dt должны быть присвоены функциями mxCalloc или mxMalloc.

Выходные аргументы

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

Состояние функции, возвращенное как int. В случае успешного выполнения функция возвращает 1.

Если pa является NULL, то функция возвращает 0.

Функция неуспешна, когда mxArray не является неразделенным mxSINGLE_CLASS массив, или если данные не выделены mxCalloc. Если функция неуспешна, то:

  • MEX-файл - функция завершает работу MEX-файла и возвращает элемент управления в подсказку MATLAB ®.

  • Автономное (не MEX-файл) приложение - функция возвращает 0.

Примеры

См. раздел arrayFillSetComplexPr.c пример в matlabroot/extern/examples/refbook папка, которая копирует существующие сложные числовые данные в mxArray. Данные в примере определяются как mxComplexDouble. Этот пример можно использовать в качестве образца для любого сложного числового типа C. Изменение этого примера для сложных single данные:

  • Объявить переменные данных как mxComplexSingle

  • Звонить mxCreateNumericMatrix с числовым типом mxSINGLE_CLASS

  • Заменить mxSetDoubles с mxSetComplexSingles чтобы поместить массив C в mxArray

Версия API

Эта функция доступна в перемежающемся комплексном API. Построить myMexFile.c с помощью этой функции введите:

mex -R2018a myMexFile.c
Представлен в R2018a