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

コード生成における table の制限事項

コード生成を目的とする MATLAB^® コードで table を作成するときは、関数 array2table、cell2table、struct2table または table を使用して作成しなければなりません。詳細については、tableを参照してください。

コード生成では、table に対して以下の制限があります。

• 関数 table、array2table または cell2table を使用して入力配列から table を作成する場合、'VariableNames' の名前と値のペアの引数を使用して変数名を指定しなければなりません。

  関数 table と 'Size' の名前と値のペアの引数を使用して table を事前に割り当てる場合、'VariableNames' 引数を指定する必要はありません。

• table 変数の名前は、有効な MATLAB 識別子である必要はありません。名前は ASCII 文字で構成されなければなりませんが、任意の ASCII 文字 (コンマ、ダッシュ、空白文字など) を含めることができます。

• 作成した後に table の VariableNames、RowNames、DimensionNames または UserData プロパティを変更することはできません。

  table の作成時に 'VariableNames' 入力引数と 'RowNames' 入力引数を指定できます。これらの入力引数はプロパティを指定します。

• table インデックスを入力引数として生成されたコードに渡すには、最初に関数 coder.Constant を使用してインデックスを定数にします。table インデックスが定数でない場合、変数にインデックス付けするとエラーが発生します。

• カスタム メタデータは table に追加できません。関数 addprop と関数 rmprop はサポートされません。

• 代入による table のサイズ変更はできません。たとえば、新しい行を追加するとエラーが発生します。

  function T = foo() %#codegen
      T = table((1:3)',(1:3)','VariableNames',{'Var1','Var2'});
      T(4,2) = 5;
  end
  

  行または変数を削除しても、エラーが発生します。

• table を事前に割り当てる場合、'VariableTypes' の名前と値のペアの引数を使用して以下のデータ型のみを指定できます。

  データ型名	各要素の初期値
  'double', 'single'	倍精度または単精度の 0
  'doublenan', 'doubleNaN', 'singlenan', 'singleNaN'	倍精度または単精度の NaN
  'int8', 'int16', 'int32', 'int64'	符号付き 8、16、32、64 ビットの整数 0
  'uint8', 'uint16', 'uint32', 'uint64'	符号なし 8、16、32、64 ビットの整数 0
  'logical'	0 (false)
  'duration'	0 秒 (duration 値として)
  'cellstr'	{''} (0 行 0 列の文字配列を含む cell)

  データ型として 'char' を指定した場合、table は対応する変数を文字配列ではなく文字ベクトルの cell 配列として事前に割り当てます。文字配列である table 変数の作成は回避することをお勧めします。

• table を垂直方向に連結する場合、同じ変数名を同じ順序でもたなければなりません。MATLAB では、変数名は同じでなければなりませんが、異なる順序にすることができます。

• table を水平方向に連結し、table が行名をもつ場合、同じ行名を同じ順序でもたなければなりません。MATLAB では、行名は同じでなければなりませんが、異なる順序にすることができます。

• 2 つの table に N 次元 cell 配列の変数がある場合、これらの table を垂直方向に連結することはできません。

• この演算は水平連結であるため、中かっこを使用して N 次元 cell 配列である複数の table 変数からデータを抽出することはできません。

• 集合メンバー関数 intersect、setdiff、setxor および union は、すべての場合において並べ替えられていない table をサポートします。'stable' オプションを指定する必要はありません。

• 関数 movevars を使用する場合、入力引数 vars には重複した変数名を含めることができません。

• 関数 convertvars を使用する場合:

  • 関数ハンドルはサポートされません。

  • 2 番目および 3 番目の入力引数 (vars および dataType) は定数でなければなりません。

  • dataType は 'char' として指定できません。

クラスに適用される制限は table にも適用されます。詳細については、コード生成のための MATLAB クラスの定義を参照してください。

参考

array2table | cell2table | struct2table | table

関連するトピック

• table のコード生成
• table 入力の定義