mxCreateCharArray (Fortran)

N 次元の mxChar 配列

Fortran 構文

#include "fintrf.h"
mwPointer mxCreateCharArray(ndim, dims)
mwSize ndim
mwSize dims(ndim)

説明

mxCreateCharArray を使用して N 次元の mxChar 配列を作成し、各要素を 0 に設定します。

MATLAB^® は、dims 引数に指定されている、後に続く大きさが 1 の次元を自動的に削除します。たとえば、ndim が 5 で dims が [4 1 7 1 1] である場合、結果の配列には 4 x 1 x 7 の次元が含まれます。

入力引数

ndim — 次元数

mwSize

次元数。mwSize として指定します。0、1、または 2 を指定した場合、mxCreateCharArray は 2 次元の mxArray を作成します。

dims — 次元配列

mwSize の配列

次元配列。mwSize の配列として指定します。

次元配列の各要素には、その次元の配列のサイズが含まれています。たとえば、5 行 7 列の配列を作成するには、dims(1) を 5 に、dims(2) を 7 に設定します。

通常、配列 dims には ndim 個の要素が含まれます。

出力引数

pm — mxArray へのポインター

mwPointer | 0

mxChar 型の mxArray へのポインター。mwPointer として指定します。

関数は、mxArray を作成するのに十分な空きヒープ領域がない場合、失敗します。

• MEX ファイル — 関数は MEX ファイルを終了し、制御を MATLAB プロンプトに戻します。

• スタンドアロン (非 MEX ファイル) アプリケーション — 関数は 0 を返します。

バージョン履歴

R2006a より前に導入

参考

mxCreateCharMatrixFromStrings | mxCreateString