Exponenta Banner

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-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 release-specific опции сборки, функция устанавливает каждый элемент в pr массив. Если ComplexFlag является 1, затем функция устанавливает pi массив в 0.

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

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

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

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

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

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

См. также

| |

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

Документация MATLAB

Поддержка