Массив ячеек MATLAB ® - это контейнер, в котором каждая ячейка может содержать массив любого типа. Модуль MATLAB C++ позволяет создавать массивы ячеек с помощью matlab::data::ArrayFactory::createCellArray функция-член. Чтобы создать пустой массив ячеек, используйте createArray<matlab::data::Array>.
Массивы ячеек можно передавать в MATLAB и из MATLAB. В MATLAB эти массивы имеют класс cell.
matlab::data::CellArray класс реализован как массив массивов, определенных как:
matlab::data::TypedArray<matlab::data::Array>
Сведения о настройке и сборке программ ядра C++ см. в разделе Сборка программ ядра C++.
Этот образец кода создает массив ячеек и помещает его в базовое рабочее пространство MATLAB.
#include "MatlabDataArray.hpp" #include "MatlabEngine.hpp"
void cellArrayPut() {
using namespace matlab::engine;
// Connect to named shared MATLAB session started as:
// matlab -r "matlab.engine.shareEngine('myMatlabEngine')"
String session(u"myMatlabEngine");
std::unique_ptr<MATLABEngine> matlabPtr = connectMATLAB(session);
// Create MATLAB data array factory
matlab::data::ArrayFactory factory;
// Create cell array
matlab::data::CellArray cellArray1 = factory.createCellArray({ 1,2 },
factory.createCharArray("MATLAB Cell Array"),
factory.createArray<double>({ 2,2 }, { 1.2, 2.2, 3.2, 4.2 }));
// Put cell array in MATLAB workspace
matlabPtr->setVariable(u"cellArray1", cellArray1);
}Вызов MATLAB whos функция показывает переменную в рабочей области MATLAB.
>> whos Name Size Bytes Class Attributes cellArray1 1x2 290 cell >> cellArray1{:} ans = 'MATLAB Cell Array' ans = 1.2000 3.2000 2.2000 4.2000
Использовать [] индексирование для доступа к элементам массива ячеек. Например, получить доступ к первому элементу массива ячеек, созданному в предыдущем разделе, и преобразовать элемент в std::string:
matlab::data::CharArray cArray = cellArray1[0][0]; std::string str = cArray.toAscii();
Переменная str является копией значения в массиве ячеек.
Существует несколько способов изменения элементов в массиве ячеек:
Создайте ссылку на элемент и измените значение в массиве ячеек.
Скопируйте элемент, измените значение, а затем переназначите его массиву ячеек.
Этот пример кода использует matlab::data::TypedArrayRef для создания ссылки на массив, содержащийся в определенной ячейке. Затем массив модифицируется путем изменения определенных элементов в массиве с помощью индексированного назначения.
#include "MatlabDataArray.hpp" #include "MatlabEngine.hpp"
void cellArrayMod() {
//Modify elements of a cell array
using namespace matlab::engine;
// Connect to named shared MATLAB session started as:
// matlab -r "matlab.engine.shareEngine('myMatlabEngine')"
String session(u"myMatlabEngine");
std::unique_ptr<MATLABEngine> matlabPtr = connectMATLAB(session);
// Create MATLAB data array factory
matlab::data::ArrayFactory factory;
// Create a 2-by-2 array of arrays
matlab::data::CellArray cellArray2 = factory.createArray<matlab::data::Array>({ 2,2 });
// Assign values to each cell
cellArray2[0][0] = factory.createCharArray("A cell array");
cellArray2[0][1] = factory.createArray<double>({ 1,3 }, { 2.2, 3.2, -4.2 });
cellArray2[1][0] = factory.createArray<bool>({ 1,3 }, { true, true, false });
cellArray2[1][1] = factory.createScalar<int32_t>(-3374);
// Get reference to elements of the cell array
// Modify the elements in the cell array
matlab::data::TypedArrayRef<double> elem1 = cellArray2[0][1];
elem1[1] = -3.2;
matlab::data::TypedArrayRef<bool> elem2 = cellArray2[1][0];
elem2[1] = false;
// Put cell array in MATLAB workspace
matlabPtr->setVariable(u"cellArray2", std::move(cellArray2));
}Массив ячеек в рабочей области MATLAB содержит изменения, внесенные в ссылки элементов массива. Вот массив ячеек в MATLAB.
>> cellArray2{:}
ans =
'A cell array'
ans =
1×3 logical array
1 0 0
ans =
2.2000 -3.2000 -4.2000
ans =
int32
-3374
Этот образец кода получает массив ячеек из MATLAB. Этот код предполагает, что существует переменная массива ячеек с именем cellArray2 в рабочей области MATLAB, как и созданная в предыдущем примере. Чтобы передать массив ячеек в MATLAB, см. раздел Изменение элементов массива ячеек.
Чтобы получить массив ячеек, выполните следующие действия.
Используйте matlab::engine::MATLABEngine
Функция члена getVariable для перевода массива ячеек в C++.
Определите возвращенный массив ячеек как matlab::data::CellArray.
Возврат содержимого ячейки, индексированной по [1][0] в качестве matlab::data::TypedArray<bool>.
Используйте TypedArray::getNumberOfElements функция-член для петли по элементам ячейки массива.
void cellArrayGet() {
using namespace matlab::engine;
// Connect to named shared MATLAB session started as:
// matlab -r "matlab.engine.shareEngine('myMatlabEngine')"
String session(u"myMatlabEngine");
std::unique_ptr<MATLABEngine> matlabPtr = connectMATLAB(session);
// Get a cell array from MATLAB
matlab::data::CellArray ca = matlabPtr->getVariable(u"cellArray2");
// Copy elements of a cell into vector
matlab::data::TypedArray<bool> const elem2 = ca[1][0];
std::vector<bool> logicalCell(elem2.getNumberOfElements());
int i = 0;
for (auto e : elem2) {
logicalCell[i] = e;
++i;
}
}matlab::data::ArrayFactory | matlab::data::TypedArray | matlab::engine::connectMATLAB | matlab::engine::MATLABEngine