exponenta event banner

mxCreateNumericMatrix (C)

2-D числовая матрица

Синтаксис C

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

Описание

Использовать mxCreateNumericMatrix для создания 2-D mxArray. classid указывает числовой тип данных элементов в массиве.

В этой таблице показан 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

Звонить mxDestroyArray по завершении использования mxArray. mxDestroyArray функция освобождает mxArray и связанные с ним реальные и мнимые элементы.

Входные аргументы

развернуть все

Количество строк, указанное как mwSize.

Количество столбцов, указанное как mwSize.

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

Индикатор сложного массива, указанный как mxComplexity значение.

Для приложений, построенных с помощью mex -R2018a , функция инициализирует каждый элемент данных в 0.

Для всех остальных mex параметры сборки для конкретного выпуска, функция устанавливает каждый элемент в pr массив. Если ComplexFlag является mxCOMPLEX, то функция устанавливает pi массив в 0.

Выходные аргументы

развернуть все

Указатель на mxArray типа classid, указано как mxArray *, в случае успеха.

Функция неуспешна, если недостаточно свободного пространства кучи для создания mxArray.

  • MEX-файл - функция завершает работу MEX-файла и возвращает элемент управления в подсказку MATLAB.

  • Автономное (не MEX-файл) приложение - функция возвращает NULL.

Примеры

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

Представлен до R2006a