Main Content

mxGetCell (C および Fortran)

cell 配列の要素へのポインター

C 構文

#include "matrix.h"
mxArray *mxGetCell(const mxArray *pm, mwIndex index);

Fortran 構文

#include "fintrf.h"
mwPointer mxGetCell(pm, index)
mwPointer pm
mwIndex index

引数

pm

セル mxArray へのポインター

index

最初の要素と目的の要素間のセル mxArray 内の要素数。多次元 cell 配列内でのインデックスの計算の詳細については、mxCalcSingleSubscript を参照してください。

戻り値

成功した場合は、i 番目のセル mxArray を指すポインター。そうでない場合は、C では NULL (Fortran では 0) を返します。失敗の原因には以下があります。

  • データが与えられていな cell 配列要素のインデックスを指定している。

  • セル mxArray を指していない pm を指定している。

  • index を mxArray の範囲外の要素に指定している。

  • 不十分なヒープ領域。

関数 mxGetCell によって返された mxArray では、mxDestroyArray を呼び出さないでください。

説明

mxGetCell を呼び出して、cell mxArray のインデックス付き要素に格納されている mxArray へのポインターを取得します。

メモ

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

例

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

バージョン履歴

R2006a より前に導入