Exponenta Banner
exponenta event banner

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около-1около-7.

В этой таблице представлены типы 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. Если 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

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

Поддержка