Массив ячеек N-D
#include "matrix.h" mxArray *mxCreateCellArray(mwSize ndim, const mwSize *dims);
#include "fintrf.h" mwPointer mxCreateCellArray(ndim, dims) mwSize ndim mwSize dims(ndim)
ndimКоличество размеров в созданной ячейке. Например, для создания трехмерной ячейки mxArray, комплект ndim до 3.
dimsМассив размеров. Каждый элемент в массиве размеров содержит размер mxArray в этом измерении. Например, в C, настройка dims[0] кому 5 и dims[1] кому 7 устанавливает 5около-7
mxArray. В Фортране, настройка dims(1) кому 5 и dims(2) кому 7 устанавливает 5около-7
mxArray. Обычно, dims массив содержит ndim элементы.
Указатель на созданный mxArray. В случае неуспешного завершения в автономном (не MEX-файле) приложении возвращает NULL в C (0 в Фортране). В случае неуспешного завершения в файле MEX файл MEX прерывается и возвращается в подсказку MATLAB ®. Функция неуспешна, если недостаточно свободного пространства кучи для создания mxArray.
Использовать mxCreateCellArray для создания ячейки mxArray с размером, определенным ndim и dims. Например, в C, чтобы установить трехмерную ячейку mxArray имеющие размеры 4около-8около-7, установить:
ndim = 3; dims[0] = 4; dims[1] = 8; dims[2] = 7;
В Фортране для установления трёхмерной ячейки mxArray имеющие размеры 4около-8около-7, установить:
ndim = 3; dims(1) = 4; dims(2) = 8; dims(3) = 7;
Созданная ячейка mxArray незаселен; mxCreateCellArray инициализирует каждую ячейку в NULL. Чтобы поместить данные в ячейку, вызовите mxSetCell.
MATLAB автоматически удаляет любые конечные одиночные размеры, указанные в dims аргумент. Например, если ndim равняется 5 и dims равняется [4 1 7 1 1], то результирующий массив имеет размеры 4около-1около-7.