外部インタフェース/API リファレンス

mxGetCell

セルの内容を取得

C 言語表示

#include "matrix.h"
mxArray *mxGetCell(const mxArray *array_ptr, int index);

引数
array_ptr
   セルmxArrayのポインタ

戻り値

成功した場合は、i番目のセルmxArrayのポインタ。そうでない場合は、NULLを出力します。失敗の原因は以下が考えられます。

• インデックス付きセル配列の要素が設定されていない。
• セルmxArrayを指していないarray_ptrを指定。
• セル内の要素数よりも大きいindexを指定。
• 出力したセルmxArrayを保持するためのフリーなヒープ領域が不十分。

詳細

セルmxGetCellを呼び出すことによって、mxArrayのインデックス付き要素内のmxArrayのポインタを取得します。

注意    MEX-ファイルの入力は、定数の参照のみのmxArray で、変更されません。mxSetCell*またはmxSetField*を使って、MATLABから渡される引数のセルまたはフィールドを変更すると、予期しない結果になることがあります。

例題

examplesディレクトリのmexサブディレクトリのexplore.cを参照してください。

参考

mxCreateCellArray, mxIsCell, mxSetCell

mxFreeMatrix (廃版)

mxGetClassID