ツールボックス関数のコード生成に対する可変サイズの制限

共通の制限事項

以下の共通制限事項は、複数のツールボックス関数に適用されます。ただし、適用されるのはコード生成時のみです。具体的なライブラリ関数にどの制限事項が適用されるかを判断するには、可変サイズデータについて制限のあるツールボックスの関数の表を参照してください。

可変長ベクトルの制限

ライブラリ関数への入力は、可変長または固定サイズのベクトルでなければなりません。可変長のベクトルとは、形状が 1x:n または :nx1 (1 つの次元が可変サイズで、もう 1 つがサイズ 1 で固定) の可変サイズの配列です。その他の形状は許可されていません。実行時にベクトルになる場合も同様です。

自動次元選択の制限事項

この制限は使用する次元 (動作する対象の次元) を入力として取得する関数に適用されます。MATLAB^® およびコード生成で、使用する次元を指定しないと、関数が次元を選択します。MATLAB では、関数は、サイズが 1 ではない最初の次元を選択します。コード生成では、関数は、可変サイズを持つまたは 1 以外の固定サイズを持つ最初の次元を選択します。使用する次元が可変サイズで、実行時に 1 になる場合、使用する次元は MATLAB の使用する次元と異なります。したがって、実行時エラーチェックが有効な場合、エラーが発生する可能性があります。

たとえば、X は、次元が 1x:3x:5 の可変サイズ行列であるとします。生成されたコードで、sum(X) は sum(X,2) のように動作します。MATLAB で、sum(X) は、size(X,2) が 1 でない場合、sum(X,2) のように動作します。MATLAB で、size(X,2) が 1 の場合は、sum(X) は sum(X,3) のように動作します。

この問題を回避するには、使用する次元を定数値で明示的に指定します。例: sum(X,2)

配列からベクトルへの変更に関する制限事項

関数は、可変長ベクトルではない可変サイズの配列が実行時にベクトルの形状をとると、エラーを発行します。この問題を回避するには、入力を可変サイズの配列ではなく可変長ベクトルとして明示的に指定します。

配列からスカラーへの変更に制限事項

関数は、可変サイズの配列が実行時にスカラー値をとると、エラーを発行します。この問題を回避するには、スカラーを固定サイズとして指定します。

可変サイズデータについて制限のあるツールボックスの関数

以下の表に、コード生成に可変サイズデータの制限がある関数を一覧表示します。これらの関数の他の制限や、コード生成でサポートされるすべての関数およびオブジェクトの制限については、C/C++ コードの生成でサポートされている関数およびオブジェクトを参照してください。

関数	可変サイズデータの制限
`all`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の可変サイズの行列を最初の引数として渡すと、エラーが発生します。
`any`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の可変サイズの行列を最初の引数として渡すと、エラーが発生します。
`cat`	次元の引数は定数でなければなりません。
`conv`	可変長ベクトルの制限を参照してください。入力ベクトルは方向が同じでなければなりません。どちらも行ベクトルか、どちらも列ベクトルかのいずれかです。
`cov`	`cov(X)` については、配列からベクトルへの変更に関する制限事項を参照してください。
`cross`	実行時にベクトルになる可変サイズ配列の入力は、同じ方向でなければなりません。
`deconv`	両方の引数については、可変長ベクトルの制限を参照してください。
`detrend`	行ベクトルの最初の引数のみについては、配列からベクトルへの変更に関する制限事項を参照してください。
`diag`	配列からベクトルへの変更に関する制限事項を参照してください。
`diff`	自動次元選択の制限事項を参照してください。入力のサイズが可変の場合、使用する次元の長さは、微分の次数の入力よりも大きくなければなりません。たとえば、入力が実行時に 3 行 5 列の可変サイズの行列の場合、`diff(x,2,1)` は動作しますが、`diff(x,5,1)` はランタイムエラーになります。
`fft`	自動次元選択の制限事項を参照してください。
`filter`	最初と 2 番目の引数については、可変長ベクトルの制限を参照してください。自動次元選択の制限事項を参照してください。
`hist`	2 番目の引数については、可変長ベクトルの制限を参照してください。 2 番目の入力引数については、配列からスカラーへの変更に制限事項を参照してください。
`histc`	自動次元選択の制限事項を参照してください。
`ifft`	自動次元選択の制限事項を参照してください。
`ind2sub`	最初の入力 (サイズベクトル入力) は固定サイズでなければなりません。
`interp1`	`xq` 入力については、配列からベクトルへの変更に関する制限事項を参照してください。 `v` が実行時に行ベクトルになると、配列からベクトルへの変更に関する制限事項が適用されます。`v` が列ベクトルになると、この制限事項は適用されません。
`interpft`	自動次元選択の制限事項を参照してください。
`ipermute`	順序の入力は固定サイズでなければなりません。
`issorted`	自動次元選択の制限事項を参照してください。
`magic`	引数は定数でなければなりません。出力は固定サイズの行列しか許されていません。
`max`	自動次元選択の制限事項を参照してください。
`maxk`	自動次元選択の制限事項を参照してください。
`mean`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の可変サイズの行列を最初の引数として渡すと、エラーが発生します。
`median`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の可変サイズの行列を最初の引数として渡すと、エラーが発生します。
`min`	自動次元選択の制限事項を参照してください。
`mink`	自動次元選択の制限事項を参照してください。
`mode`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の可変サイズの行列を最初の引数として渡すと、エラーが発生します。
`mtimes`	乗算 `A*B` について考えます。コードジェネレーターは、`A` がスカラーで `B` が行列であることを認識すると、スカラー行列乗算のコードを生成します。ただし、コードジェネレーターは、`A` と `B` が可変サイズの行列であると認識すると、一般的な行列乗算のコードを生成します。実行時に、`A` がスカラーであることが判明しても、生成されたコードはその動作を変更しません。したがって、実行時エラーチェックが有効な場合、サイズの不一致エラーが発生する可能性があります。
`nchoosek`	2 番目の入力の `k` は固定サイズのスカラーでなければなりません。 2 番目の入力の `k` は、静的な割り当てに使用する定数でなければなりません。動的な割り当てが有効な場合は、2 番目の入力は変数でも構いません。動的な割り当てを有効にしない限り、変数 `k` を受け取って可変サイズの配列を作成することはできません。
`permute`	順序の入力は固定サイズでなければなりません。
`planerot`	入力は、固定サイズで 2 つの要素をもつ列ベクトルでなければなりません。実行時に 2 行 1 列のサイズをとる可変サイズの配列は指定できません。
`poly`	可変長ベクトルの制限を参照してください。
`polyfit`	最初と 2 番目の引数については、可変長ベクトルの制限を参照してください。
`prod`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の可変サイズの行列を最初の引数として渡すと、エラーが発生します。
`rand`	上限のある変数 `N` に対して、`rand(1,N)` は `1x:M` の可変長のベクトルを生成します。ここで、`M` は `N` の上限です。上限のある変数 `N` に対して、`rand([1 N])` は `:1x:M` の可変長のベクトルを生成する場合があります。ここで、`M` は `N` の上限です。
`randi`	上限のある変数 `N` に対して、`randi(imax,1,N)` は `1 行 :M 列`の可変長のベクトルを生成します。ここで、`M` は `N` の上限です。上限のある変数 `N` に対して、`randi(imax,[1 N])` は `:1x:M` の可変長のベクトルを生成する場合があります。ここで、`M` は `N` の上限です。
`randn`	上限のある変数 `N` に対して、`randn(1,N)` は `1x:M` の可変長のベクトルを生成します。ここで、`M` は `N` の上限です。上限のある変数 `N` に対して、`randn([1 N])` は `:1x:M` の可変長のベクトルを生成する場合があります。ここで、`M` は `N` の上限です。
`reshape`	入力が可変サイズの配列で出力配列に 1 つ以上の固定長の次元が含まれている場合、出力の次元のサイズをサイズベクトル `sz` で指定しないでください。代わりに出力の次元のサイズをスカラー値 `sz1,...,szN` で指定します。固定サイズの次元は定数で指定してください。入力が可変サイズの空配列の場合、出力配列 (こちらも空) の最大次元サイズは、入力のサイズより大きくすることができません。
`roots`	可変長ベクトルの制限を参照してください。
`shiftdim`	2 番目の引数を指定しない場合、シフトの数はコンパイル時に次元サイズの上限によって決定されます。そのため、実行時にはシフトの数が一定になります。実行時に 1 番目の次元にシフトする次元の長さが 1 になると、エラーが発生します。このエラーを回避するには、2 番目の入力引数としてシフトの数を (定数でなければならない) 指定します。正のシフト数を指定した場合、最初の入力引数は、同じ数の次元をもたなければなりません。
`sort`	自動次元選択の制限事項を参照してください。
`std`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の次元の可変サイズの行列を渡すと、エラーが発生します。
`sub2ind`	最初の入力 (サイズベクトル入力) は固定サイズでなければなりません。
`sum`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の可変サイズの行列を最初の引数として渡すと、エラーが発生します。
`trapz`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の可変サイズの行列を最初の引数として渡すと、エラーが発生します。
`typecast`	可変長ベクトルの制限の最初の引数に関する部分を参照してください。
`var`	自動次元選択の制限事項を参照してください。実行時に 0 行 0 列の次元の可変サイズの行列を渡すと、エラーが発生します。
`vecnorm`	自動次元選択の制限事項を参照してください。