exponenta event banner

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около-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около-1около-7.

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