External Interfaces/API Reference

mxCreateStructMatrix

Create an unpopulated two-dimensional structure mxArray

Fortran Syntax

• integer*4 function mxCreateStructMatrix(m, n, nfields, fieldnames)
  integer*4 m, n, nfields
  character*(*) fieldnames(nfields)
  

Arguments

m
   The desired number of rows. This must be a positive integer.

n
   The desired number of columns. This must be a positive integer.

nfields
   The desired number of fields in each element.

fieldnames
   The desired list of field names.

Returns

A pointer to the created structure mxArray if successful, and 0 otherwise. The most likely cause of failure is insufficient heap space to hold the returned mxArray.

Description

mxCreateStructMatrix and mxCreateStructArray are almost identical. The only difference is that mxCreateStructMatrix can only create two-dimensional mxArrays, while mxCreateStructArray can create mxArrays having two or more dimensions.

See Also

mxCreateStructArray, mxIsStruct, mxAddField, mxSetField, mxGetField, mxRemoveField

mxCreateStructArray

mxDestroyArray