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 для удаления памяти.

Следующая таблица показывает classid C значения, эквивалентные классам 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