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

mxGetString

mxArrayからキャラクタ配列を作成

Fortran 言語表示

integer*4 function mxGetString(pm, str, strlen)
integer*4 pm, strlen
character*(*) str

引数
pm
   mxArrayのポインタ。

戻り値

成功した場合は0、そうでない場合は1。

詳細

mxGetStringを呼び出すことによって、mxArrayからキャラクタ配列をコピーします。mxGetStringは、キャラクタ配列をmxArray pmからキャラクタ配列strにコピーし、変換します。キャラクタ配列strに対するストレージ領域は、前もって割り当てられていなければなりません。

strlenキャラクタまでコピーされるので、通常strlenは配列の最後を越えて書き込むことを防ぐために、キャラクタ配列の大きさに設定されます。mxGetMとmxGetNを使って、前もってキャラクタ配列の長さをチェックしてください。キャラクタ配列が複数の行を含む場合は、それらは一度に1列づつ、1つの長いキャラクタ配列にコピーされます。