Exponenta Banner

mxCreateStructArray (Fortran)

Массив структур N-D

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

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

#include "fintrf.h"
mwPointer mxCreateStructArray(ndim, dims, nfields, fieldnames)
mwSize ndim
mwSize dims(ndim)
integer*4 nfields
character*(*) fieldnames(nfields)

Описание

Вызовите mxCreateStructArray создать безлюдную структуру mxArray. Каждый элемент структуры mxArray содержит то же количество полей, заданных в nfields. Каждое поле имеет имя, заданное в fieldnames.

Каждое поле содержит один mxArray указатель инициализируется к 0. Вызовите mxSetField или mxSetFieldByNumber поместить non-0 mxArray указатель в поле.

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

Вызовите mxDestroyArray когда вы закончили использовать mxArray. mxDestroyArray функция освобождает mxArray и его связанные действительные и мнимые элементы.

Входные параметры

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

Количество размерностей, заданных как mwSize. Если ndim меньше 2, затем mxCreateStructArray определяет номер размерностей к 2.

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

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

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

Количество полей в каждом элементе, указанном как integer*4.

Одни или несколько имен полей, заданных как character*(*).

Имена полей должны быть допустимыми идентификаторами MATLAB®, что означает, что они не могут быть пустыми. Имена полей являются чувствительными к регистру. Чтобы определить максимальную длину имени поля, используйте namelengthmax функция.

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

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

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

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

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

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

Смотрите также

| | | | | |

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

Документация MATLAB
Поддержка