mxCreateStructMatrix (Fortran)

2-D structure array

Fortran Syntax

#include "fintrf.h"
mwPointer mxCreateStructMatrix(m, n, nfields, fieldnames)
mwSize m, n
integer*4 nfields
character*(*) fieldnames(nfields)

Description

Call mxCreateStructMatrix to create an unpopulated, two-dimensional, structure mxArray. For information about the structure, see mxCreateStructArray.

Call mxDestroyArray when you finish using the mxArray. mxDestroyArray deallocates the mxArray and its associated elements.

Input Arguments

m — Number of rows

mwSize

Number of rows, specified as mwSize.

n — Number of columns

mwSize

Number of columns, specified as mwSize.

nfields — Number of fields

integer*4

Number of fields in each element, specified as integer*4.

fieldnames — Field names

character*(*)

One or more field names, specified as character*(*).

Field names must be valid MATLAB^® identifiers, which means they cannot be empty. Field names are case-sensitive. To determine the maximum length of a field name, use the namelengthmax function.

pm — Pointer to mxArray

mwPointer | 0

Pointer to an mxArray, specified as mwPointer, if successful.

The function is unsuccessful when there is not enough free heap space to create the mxArray.

• MEX file — Function terminates the MEX file and returns control to the MATLAB prompt.

• Standalone (non-MEX file) application — Function returns 0.

Version History

Introduced before R2006a