mxAddField (C and Fortran)

Add field to structure array

C Syntax

#include "matrix.h"
extern int mxAddField(mxArray *pm, const char *fieldname);

Fortran Syntax

#include "fintrf.h"
integer*4 mxAddField(pm, fieldname)
mwPointer pm
character*(*) fieldname

Arguments

pm

Pointer to a structure mxArray

fieldname

Name of the field you want to add

Returns

Field number on success, or -1 if inputs are invalid or an out-of-memory condition occurs.

Description

Call mxAddField to add a field to a structure array. Create the values with the mxCreate* functions and use mxSetFieldByNumber to set the individual values for the field.