exponenta event banner

mxCreateUninitNumericArray (C)

Неинициализированный цифровой массив N-D

Синтаксис C

#include "matrix.h"
mxArray *mxCreateUninitNumericArray(size_t ndim, size_t *dims, 
  mxClassID classid, mxComplexity ComplexFlag);

Аргументы

ndim

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

dims

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

classid

Идентификатор класса массива, определяющий способ представления числовых данных в памяти. Например, указание mxINT16_CLASS вызывает каждую часть числовых данных в mxArray для представления в виде 16-битного целого числа со знаком.

ComplexFlag

Если mxArray создаваемый объект должен содержать мнимые данные, набор ComplexFlag кому mxCOMPLEX. В противном случае установите ComplexFlag кому mxREAL.

Прибыль

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

Описание

Звонить mxCreateUninitNumericArray для создания N-мерного mxArray в котором все элементы данных имеют числовой тип данных, указанный classid. Элементы данных не инициализированы.

mxCreateUninitNumericArray выделяет динамическую память для хранения созданного mxArray. Звонить mxDestroyArray для освобождения памяти.

В следующей таблице показан C classid значения, эквивалентные классам MATLAB.

Имя класса MATLAB

C classid Стоимость

int8

mxINT8_CLASS

uint8

mxUINT8_CLASS

int16

mxINT16_CLASS

uint16

mxUINT16_CLASS

int32

mxINT32_CLASS

uint32

mxUINT32_CLASS

int64

mxINT64_CLASS

uint64

mxUINT64_CLASS

single

mxSINGLE_CLASS

double

mxDOUBLE_CLASS

Представлен в R2015a