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-by- 1-by- 7.

Входные параметры

расширить все

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

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

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

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

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

расширить все

Указатель на mxArray типа mxChar, заданный как mxArray *.

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

  • Файл MEX - Function завершает Файл MEX и возвращает управление в подсказку MATLAB.

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

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