mxCreateNumericMatrix (Fortran)

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

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

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

Описание

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

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

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

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

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

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

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

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

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

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

Примеры

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

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