C++ MATLAB ® Data API поддерживает использование классов посетителей через matlab::data::apply_visitor и matlab::data::apply_visitor_ref функции. Эти функции принимают в качестве входных данных массив или ссылку на массив и класс посетителей.
apply_visitor и apply_visitor_ref функции отправляются в операции, определенные классом посетителей на основе типа входного массива. Класс visitor определяет операции, выполняемые с определенными типами массива.
Используйте шаблон посетителя в следующих случаях:
Существует много операций, которые необходимо выполнить для массива, и способ их выполнения зависит от типа массива.
Массив, возвращаемый функцией, может быть различных известных типов, и необходимо обработать все случаи.
Вы работаете с гетерогенными структурами, такими как массивы ячеек или массивы структур.
apply_visitor функция отправляет операции класса visitor на основе типа входного массива. Синтаксис вызова apply_visitor принимает matlab::data::Array и экземпляр класса посетителей:
auto apply_visitor(matlab::data::Array a, V visitor)
apply_visitor_ref функция отправляет операцию класса visitor на основе типа ссылки массива, передаваемого в качестве входных данных. Синтаксис вызова apply_visitor_ref принимает matlab::data::ArrayRef и экземпляр класса посетителей:
auto apply_visitor_ref(const matlab::data::ArrayRef& a, V visitor)
operator()Реализация класса посетителей для перегрузки оператора operator() для типов массивов, с которыми требуется работать. Например, предположим, что одна из операций, которую требуется реализовать, заключается в возврате текста, содержащегося в matlab::data::CharArray в качестве std::string. Выполните операцию следующим образом:
std::string operator()(matlab::data::CharArray arr){
return arr.toAscii();
}В качестве другого примера предположим, что требуется отменить логические значения в matlab::data::TypedArray. В этом случае используйте ссылку на массив:
void operator()(TypedArrayRef<bool> boolArrRef) {
std::cout << "Negate logical value: " << std::endl;
for (auto &b : boolArrRef) {
b = !b;
}
}Необходимо использовать ссылку на элемент в диапазоне for для изменения значения в массиве.
В этом примере показано, как использовать класс посетителей для определения операций, выполняемых для определенных типов matlab::data::Array.
DisplayVisitor класс реализует операции отображения содержимого массивов ячеек для массивов типов bool, double, и charи содержали массивы ячеек. Можно добавить новые операции для поддержки другого содержимого массива ячеек, добавив дополнительные перегруженные функции.
type DisplayVisitor.cpp#include "MatlabDataArray.hpp"
#include <iostream>
using namespace matlab::data;
void DisplayCell(const CellArray cellArray);
class DisplayVisitor {
public:
template <typename U>
void operator()(U arr) {}
void operator()(const TypedArray<bool> boolArr) {
std::cout << "Cell contains logical array: " << std::endl;
for (auto b : boolArr) {
printf_s("%d ", b);
}
std::cout << "\n";
}
void operator()(const TypedArray<double> doubleArr) {
std::cout << "Cell contains double array: " << std::endl;
for (auto elem : doubleArr) {
std::cout << elem << " ";
}
std::cout << "\n";
}
void operator()(const CharArray charArr) {
std::cout << "Cell contains char array: " << std::endl;
for (auto elem : charArr) {
std::cout << char(elem);
}
std::cout << "\n";
}
void operator()(const CellArray containedCellArray) {
DisplayCell(containedCellArray);
}
};
void DisplayCell(const CellArray cellArray) {
DisplayVisitor v;
for (auto elem : cellArray) {
apply_visitor(elem, v);
}
}
Чтобы использовать класс, передайте массив ячеек в DisplayCell функция.
type callDisplayCell.cppint main() {
ArrayFactory factory;
// Create cell array
matlab::data::CellArray cellArray = factory.createCellArray({ 1,4 },
factory.createCharArray("A char array"),
factory.createArray<bool>({ 1,2 }, { false, true }),
factory.createArray<double>({ 2,2 }, { 1.2, 2.2, 3.2, 4.2 }),
factory.createCellArray({ 1,1 }, false));
// Call function
DisplayCell(cellArray);
return 0;
}
В этом примере CellModifyVisitor класс реализует операции по изменению содержимого массивов ячеек типов bool, double, и charи содержали массивы ячеек. Можно добавить новые операции для поддержки другого содержимого массива ячеек, добавив дополнительные перегруженные функции.
ModifyCell вызовы функций apply_visitor_ref в цикле для каждого элемента в массиве ячеек. Поскольку целью является изменение содержимого массива ячеек, в этом примере используются ссылки на содержимое массива ячеек.
type CellModifyVisitor.cpp#include "MatlabDataArray.hpp"
#include "MatlabEngine.hpp"
#include <iostream>
using namespace matlab::data;
void ModifyCell(CellArray &cellArray);
class CellModifyVisitor {
public:
template <typename U>
void operator()(U arr) {}
void operator()(TypedArrayRef<bool> boolArrRef) {
std::cout << "Negate logical value: " << std::endl;
for (auto &b : boolArrRef) {
b = !b;
}
}
void operator()(TypedArrayRef<double> doubleArrRef) {
std::cout << "Add 1 to each value: " << std::endl;
for (auto &elem : doubleArrRef) {
elem = elem + 1;
}
std::cout << "\n";
}
void operator()(CharArrayRef charArrRef) {
std::cout << "Modify char array" << std::endl;
ArrayFactory factory;
charArrRef = factory.createCharArray("Modified char array");
}
void operator()(CellArrayRef containedCellArray) {
CellModifyVisitor v;
for (auto elem : containedCellArray) {
apply_visitor_ref(elem, v);
}
}
};
void ModifyCell(CellArray &cellArray) {
CellModifyVisitor v;
for (auto elem : cellArray) {
apply_visitor_ref(elem, v);
}
}
Чтобы использовать класс, передайте массив ячеек в ModifyCell функция.
type callModifyCell.cppint main() {
ArrayFactory factory;
// Create cell array
matlab::data::CellArray cellArray = factory.createCellArray({ 1,4 },
factory.createCharArray("A char array"),
factory.createArray<bool>({ 1,2 }, { false, true }),
factory.createArray<double>({ 2,2 }, { 1.2, 2.2, 3.2, 4.2 }),
factory.createCellArray({ 1,1 }, false));
// Call function
ModifyCell(cellArray);
return 0;
}
matlab::data::apply_visitor | matlab::data::apply_visitor_ref