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 освобождать память.

Следующая таблица показывает 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