exponenta event banner

mxCreateUninitNumericMatrix (C)

Неинициализированная 2-D числовая матрица

Синтаксис C

#include "matrix.h"
mxArray *mxCreateUninitNumericMatrix(size_t m, size_t n, 
  mxClassID classid, mxComplexity ComplexFlag);

Аргументы

m

Количество строк

n

Количество столбцов

classid

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

ComplexFlag

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

Прибыль

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

Пример

См. эти примеры в разделе matlabroot/extern/examples/mx:

Описание

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

mxCreateUninitNumericMatrix выделяет динамическую память для хранения созданного 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