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-by- 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