mxCreateNumericArray (Фортран)

Числовой массив 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-by-1-by-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-by-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

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