Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

mxGetData (Fortran)

非数値 mxArray 内のデータ要素

mxGetData は数値配列用には推奨されません。代わりに、型付きのデータ アクセス関数を使用してください。詳細については、互換性についての考慮事項を参照してください。

Fortran 構文

#include "fintrf.h"
mwPointer mxGetData(pm)
mwPointer pm

説明

mxGetData は、非数値配列のみのデータ要素の取得に使用します。

数値配列の場合、インターリーブされた複素数 API で型付きのデータ アクセス関数を使用するように、MEX ファイルを作成し、既存の MEX ファイルを更新することを MathWorks では推奨します。詳細については、以下を参照してください。

MEX ファイルをビルドするには、-R2018a オプションを指定して mex を呼び出します。

入力引数

すべて展開する

非数値 MATLAB 配列へのポインター。mwPointer として指定します。

出力引数

すべて展開する

mxArray 内のデータ配列へのポインター。mwPointer として指定します。void ポインターは型のない値を指すので、戻り値は pm によって指定されている型に一致するポインター型にキャストします。

返されたポインターからの値をコピーするには、関数 mxCopyPtrTo* のいずれかを使用します。以下に例を示します。

C      Get the data in mxArray, pm
       mxCopyPtrToReal8(mxGetData(pm),data,
     +                  mxGetNumberOfElements(pm))

pm0 の場合、関数は 0 を返します。

互換性についての考慮事項

すべて展開する

R2018b での動作変更

R2006a より前に導入