mxCreateLogicalArray (C)

N-D логический массив

Синтаксис C

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

Аргументы

ndim

Количество размерностей. Если вы задаете значение для ndim что меньше 2, mxCreateLogicalArray автоматически устанавливает количество размерностей равным 2.

dims

Размерности. Каждый элемент массива размерностей содержит размер массива в этом измерении. Для примера установка dims[0] на 5 и dims[1] на 7 устанавливает 5-by- 7 mxArray. Есть ndim элементы в dims массив.

Возвраты

Указатель на созданную mxArray. При неудаче в автономном (не-MEX-файле) приложении возвращается NULL. При неудаче в файле MEX файл MEX завершает работу и возвращает управление в MATLAB® приглашение. Функция неудачна, когда не хватает свободного пространства в куче, чтобы создать mxArray.

Описание

Звонить mxCreateLogicalArray для создания N-мерной mxArray от mxLogical элементы. После создания mxArray, mxCreateLogicalArray инициализирует все его элементы в логические 0. mxCreateLogicalArray отличается от mxCreateLogicalMatrix при этом последние могут создавать только двумерные массивы.

mxCreateLogicalArray выделяет динамическую память для хранения созданных mxArray. Когда вы заканчиваете с созданной mxArray, вызов mxDestroyArray чтобы отселить его память.

MATLAB автоматически удаляет все конечные размерности синглтона, указанные в dims аргумент. Для примера, если ndim равен 5 и dims равен [4 1 7 1 1], тогда получившийся массив имеет размерности 4-by- 1-by- 7.

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