Exponenta Banner

mxCreateNumericMatrix (C)

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

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

Синтаксис C

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

Описание

Использовать mxCreateNumericMatrix для создания 2-D mxArray. The 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 перечисление. The classid аргумент определяет, как числовые данные представлены в памяти. Для примера, mxCreateNumericMatrix хранит mxINT16_CLASS значения как 16-битные целые числа со знаком.

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

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

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

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

расширить все

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

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

  • Файл MEX - Function завершает Файл MEX и возвращает управление в подсказку MATLAB.

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

Примеры

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

См. также

| | | |

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

Документация MATLAB

Поддержка