mxCreateStructArray (Фортран)

Массив структур 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-by-1-by-7.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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