mxCreateNumericMatrix (Фортран)

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

Синтаксис языка ФОРТРАН

#include "fintrf.h"
mwPointer mxCreateNumericMatrix(m, n, classid, ComplexFlag)
mwSize m, n
integer*4 classid, ComplexFlag

Описание

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

Эта таблица показывает типы Фортрана, которые эквивалентны классам MATLAB®.

Имя класса MATLAB

Тип Фортрана

int8

BYTE

int16

INTEGER*2

int32

INTEGER*4

int64

INTEGER*8

single

REAL*4
COMPLEX*8

double

REAL*8
COMPLEX*16

Вызовите mxDestroyArray, когда вы закончите использовать mxArray. Функция mxDestroyArray освобождает mxArray и его связанные действительные и мнимые элементы.

Входные параметры

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

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

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

Идентификатор класса, заданный как integer*4. Аргумент classid определяет, как числовые данные представлены в памяти. Используйте функцию mxClassIdFromClassName, чтобы получить значение classid на имя класса MATLAB.

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

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

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

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

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

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

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

  • Файл MEX — Функция отключает файл MEX и возвращает управление в посдказку MATLAB.

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

Примеры

Эти операторы Fortran создают 4-by-3 матрица элементов REAL*4, имеющих мнимые компоненты:

C      Create 4x3 mxArray of REAL*4
       mxCreateNumericMatrix(4, 3,
     +                mxClassIDFromClassName('single'), 0)

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