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-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 - Function завершает Файл MEX и возвращает управление в подсказку MATLAB.

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

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