mxCreateCharArray (C и Фортран)

N-D массив mxChar

Синтаксис C

#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.

Смотрите также

mxCreateCharMatrixFromStrings, mxCreateString

Была ли эта тема полезной?