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