exponenta event banner

mxSetComplexInt16s (C)

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

Синтаксис C

#include "matrix.h"
int mxSetComplexInt16s(mxArray *pa, mxComplexInt16 *dt);

Описание

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

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

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

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

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

Версия API

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

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