Learn more about MATLAB

mxSetCell (C and Fortran) - Set value of one cell of mxArray

C Syntax

#include "matrix.h"
void mxSetCell(mxArray *pm, mwIndex index, mxArray *value);

Fortran Syntax

mxSetCell(pm, index, value)
mwPointer pm, value
mwIndex index

Arguments

pm

Pointer to a cell mxArray

index

Index from the beginning of the mxArray. Specify the number of elements between the first cell of the mxArray and the cell you want to set. The easiest way to calculate index in a multidimensional cell array is to call mxCalcSingleSubscript.

value

New value of the cell. You can put any kind of mxArray into a cell. In fact, you can even put another cell mxArray into a cell.

Description

Call mxSetCell to put the designated value into a particular cell of a cell mxArray.

Note   Inputs to a MEX-file are constant read-only mxArrays. Do not modify the inputs. Using mxSetCell* or mxSetField* functions to modify the cells or fields of a MATLAB argument causes unpredictable results.

This function does not free any memory allocated for existing data that it displaces. To free existing memory, call mxDestroyArray on the pointer returned by mxGetCell before you call mxSetCell.

C Examples

See phonebook.c in the matlabroot/extern/examples/refbook folder . For an additional example, see mxcreatecellmatrix.c in the matlabroot/extern/examples/mx folder .

See Also

mxCreateCellArray, mxCreateCellMatrix, mxGetCell, mxIsCell, mxDestroyArray

mxRemoveField (C and Fortran)

mxSetClassName (C)

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS