exponenta event banner

mxCreateNumericMatrix (Фортран)

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

Синтаксис Фортрана

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

Описание

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

В этой таблице представлены типы Fortran, эквивалентные классам 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около-3 матрица REAL*4 элементы, не имеющие мнимых компонентов:

C      Create 4x3 mxArray of REAL*4
       mxCreateNumericMatrix(4, 3,
     +                mxClassIDFromClassName('single'), 0)
Представлен до R2006a