mxCreateNumericMatrix (C)

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

Синтаксис C

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

Описание

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

Эта таблица показывает 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

Вызовите 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

Для просмотра документации необходимо авторизоваться на сайте