mxSetCell (C および Fortran)

cell 配列の内容を設定

C 構文

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

#include "fintrf.h"
subroutine mxSetCell(pm, index, value)
mwPointer pm, value
mwIndex index

pm: セル mxArray へのポインター
index: mxArray の先頭からのインデックス。mxArray の最初のセルと、設定するセルとの間の要素の数を指定します。多次元 cell 配列内の index を計算するには、関数 mxCalcSingleSubscript を呼び出すのが最も簡単です。
value: セルの新しい値へのポインター。セルには任意の型の mxArray を配置できます。別のセルの mxArray をセルに配置することもできます。

mxSetCell を呼び出して、指定された value を cell mxArray の特定のセルに配置します。

メモ

MEX ファイルへの入力値は、読み取り専用の定数 mxArray です。入力値を変更しないでください。関数 mxSetCell* または関数 mxSetField* を使用して MATLAB^® 引数のセルまたはフィールドを変更すると、予期しない結果が生じます。

この関数は、置き換える既存のデータに割り当てられているメモリは解放しません。既存のメモリを解放するには、mxSetCell を呼び出す前に、mxGetCell の返すポインターにある mxDestroyArray を呼び出します。

matlabroot/extern/examples/refbook の次の例を参照してください。

matlabroot/extern/examples/mx の次の例を参照してください。

R2006a より前に導入