mxCreateNumericArray (Fortran)

Числовой массив N-D

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

#include "fintrf.h"
mwPointer mxCreateNumericArray(ndim, dims, classid, ComplexFlag)
mwSize ndim
mwSize dims(ndim)
integer*4 classid, ComplexFlag

Описание

Используйте mxCreateNumericArray создать N-мерный mxArray.

mxCreateNumericArray отличается от mxCreateDoubleMatrix можно следующим образом:

  • Все элементы данных в mxCreateDoubleMatrix двойная точность, числа с плавающей запятой. Элементы данных в mxCreateNumericArray может быть любой числовой тип, включая различную целочисленную точность.

  • mxCreateDoubleMatrix создает двумерные массивы только. mxCreateNumericArray может создать массивы двух или больше размерностей.

MATLAB® автоматически удаляет любые запаздывающие одноэлементные размерности, заданные в dims аргумент. Например, если ndim равняется 5 и dims равняется [4 1 7 1 1], затем полученный массив имеет размерности 4- 1- 7.

Эта таблица показывает типы Фортрана, которые эквивалентны классам 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. Если ndim меньше 2, затем mxCreateNumericArray определяет номер размерностей к 2.

Массив размерностей, заданный как массив mwSize.

Каждый элемент в массиве размерностей содержит размер массива в той размерности. Например, чтобы создать 5- 7 массив, набор dims(1) к 5 и dims(2) к 7.

Обычно, dims массив содержит ndim элементы.

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

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

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

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

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

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

Указатель на mxArray из типа classid, заданный как mwPointer.

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

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

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

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

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