| MATLAB Application Program Interface Reference | Help Desk |
mxSetFieldByNumber
Set a field value in a structure array, given a field number and an index
#include "matrix.h" void mxSetFieldByNumber(mxArray *array_ptr, int index, int field_number, mxArray *value);array_ptr
Pointer to a structure mxArray. Call mxIsStruct to determine if array_ptr points to a structure mxArray.
The desired element. The first element of an mxArray has an index of 0, the second element has an index of 1, and the last element has an index of N-1, where N is the total number of elements in the structure mxArray. See mxCalcSingleSubscript for details on calculating an index.
The position of the field whose value you want to extract. The first field within each element has a field_number of 0, the second field has a field_number of 1, and so on. The last field has a field_number of N-1, where N is the number of fields.
mxSetFieldByNumber to assign a value to the specified element of the specified field. mxSetFieldByNumber is almost identical to mxSetField; however, the former takes a field number as its third argument and the latter takes a field name as its third argument.
mxCreateStructArray, mxCreateStructMatrix, mxGetField, mxGetFieldByNumber, mxGetFieldNameByNumber, mxGetFieldNumber, mxGetNumberOfFields, mxIsStruct, mxSetField