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. В массиве dims существуют элементы ndim.

Возвращается

Указатель на созданный mxArray. Если неудачный в автономном (нефайл MEX) приложение, возвращает NULL в C (0 на Фортране). Если неудачный в файле 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

Для просмотра документации необходимо авторизоваться на сайте