Объект MATLAB для массивов C++

MATLAB^® обеспечивает интерфейс, clib.array, который переносит собственные массивы C++ и std::vector типы. Термин clib array относится к представлению MATLAB этих типов C++.

MATLAB clib массив только задан когда соответствующий собственный массив C++ или std::vector используется поддерживаемыми построениями C++ — входной параметр функции и выходные аргументы и элементы данных. Обеспеченные заголовки должны содержать определение типа элемента. Построение должно поддерживаться MATLAB и не пропущенное при создании интерфейса.

Создайте объект MATLAB, представляющий массив C++

Чтобы создать объект MATLAB передать функции C++, вызовите MATLAB clibArray функция. Например, предположите что ваша библиотека libname задает класс myclass. В MATLAB вы называете этот класс clib.libname.myclass. Создать массив пяти myclass объекты, используйте этот синтаксис:

myclassArray = clibArray('clib.libname.myclass',5);

Тип массива MATLAB myclassArray clib.array.libname.myclass. Получить доступ к элементу myclassArray, используйте индексацию MATLAB. Например, чтобы получить доступ к первому элементу, используйте этот синтаксис:

e = myclassArray(1)

Типом элемента является clib.libname.myclass.

Примечание

Сохранение объектов C++ в MAT-файл не поддерживается.

Преобразуйте массив MATLAB в объект C++ массивов

Можно использовать существующий массив MATLAB в качестве объекта C++ массивов. Вызовите clibConvertArray функция.

Свойства массива объекта C++ MATLAB

Массивы MATLAB, созданные с clibArray или clibConvertArray имейте эти свойства.

Свойство	Ввод	Доступ	Описание
`Dimensions`	`double vector`	только для чтения	Размерности C++ массива
`Resizable`	`logical scalar`	только для чтения	`true`— добавьте/удалите позволенный элемент `false`— добавьте/удалите элемент, не позволенный

Свойство

Ввод

Доступ

Описание

Dimensions

double vector

только для чтения

Размерности C++ массива

Resizable

logical scalar

только для чтения

true— добавьте/удалите позволенный элемент
false— добавьте/удалите элемент, не позволенный

Методы объекта C++ массивов MATLAB

Массивы MATLAB, созданные с clibArray или clibConvertArray имейте эти методы.

Метод	Подпись	Описание
`append`	`append([element])`	Добавьте опционально указанный элемент в конец массива. Для примитивного MATLAB clib массив, если нет никакого входного параметра, то нулевое значение добавлено. Для типа класса MATLAB clib массив, если нет никакого входного параметра, то конструктор по умолчанию типа класса добавлен. Если конструктор по умолчанию типа класса удален, ошибка периода выполнения происходит.
`removeLast`	`removeLast`	Удалите последний элемент массива. Если MATLAB clib массив пуст, ошибка периода выполнения происходит.
`double`	`double`	Преобразуйте в двойную точность.
`int8`	`int8`	Преобразуйте в `int8`.
`uint8`	`uint8`	Преобразуйте в `uint8`.
`int16`	`int16`	Преобразуйте в `int16`.
`uint16`	`uint16`	Преобразуйте в `uint16`.
`int32`	`int32`	Преобразуйте в `int32`.
`uint32`	`uint32`	Преобразуйте в `uint32`.
`int64`	`int64`	Преобразуйте в `int64`.
`uint64`	`uint64`	Преобразуйте в `uint64`.
`logical`	`logical`	Преобразуйте числовые значения в логический.

Необъект обработки массивы C++ как фундаментальные типы MATLAB

По умолчанию MATLAB представляет std::vector типы с clib.array MATLAB ввод. Если необходимо сохранить основные типы массива MATLAB с выходными параметрами, то создайте интерфейс с ReturnCArrays набор аргумента к false. Для получения дополнительной информации смотрите clibgen.generateLibraryDefinition.

Управление памятью

Память для массивов MATLAB, созданных с clibArray или clibConvertArray принадлежит MATLAB. Чтобы выпустить память, вызвать clibRelease.

Документация