Exponenta Banner
exponenta event 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 для размещения не-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

Поддержка