exponenta event banner

mxCreateCharArray (C)

Синтаксис C

#include "matrix.h"
mxArray *mxCreateCharArray(mwSize ndim, const mwSize *dims);

Описание

Использовать mxCreateCharArray для создания N-мерного mxChar массив с каждым элементом, имеющим значение NULL.

MATLAB ® автоматически удаляет любые конечные одиночные размеры, указанные в dims аргумент. Например, если ndim равняется 5 и dims равняется [4 1 7 1 1], то результирующий массив имеет размеры 4около-1около-7.

Входные аргументы

развернуть все

Количество размеров, указанное как mwSize. Если указать 0, 1 или 2, то mxCreateCharArray создает двумерный mxArray.

Массив размеров, указанный как const mwSize *.

Каждый элемент в массиве размеров содержит размер массива в этом измерении. Например, для создания 5около-7 массив, набор dims[0] до 5 и dims[1] до 7.

Обычно, dims массив содержит ndim элементы.

Выходные аргументы

развернуть все

Указатель на mxArray типа mxChar, указано как mxArray *.

Функция неуспешна, если недостаточно свободного пространства кучи для создания mxArray.

  • MEX-файл - функция завершает работу MEX-файла и возвращает элемент управления в подсказку MATLAB.

  • Автономное (не MEX-файл) приложение - функция возвращает NULL.

Представлен до R2006a