perms

可能なすべての置換

構文

P = perms(v)

説明

P = perms(v) は、ベクトル v の要素のすべての置換 (順列) を含む行列を返します。P の各行は、v の n 個の要素の異なる置換を含みます。行列 P は v と同じデータ型で、n! 行 n 列をもちます。

例

double の整数のすべての置換

v = [2 4 6];
P = perms(v)

P = 6×3

     6     4     2
     6     2     4
     4     6     2
     4     2     6
     2     6     4
     2     4     6

符号なしの整数のすべての置換

v = uint16([1023 4095 65535]);
P = perms(v)

P = 6×3 uint16 matrix

   65535    4095    1023
   65535    1023    4095
    4095   65535    1023
    4095    1023   65535
    1023   65535    4095
    1023    4095   65535

複素数のすべての置換

v = [1+1i 2+1i 3+1i];
P = perms(v)

P = 6×3 complex

   3.0000 + 1.0000i   2.0000 + 1.0000i   1.0000 + 1.0000i
   3.0000 + 1.0000i   1.0000 + 1.0000i   2.0000 + 1.0000i
   2.0000 + 1.0000i   3.0000 + 1.0000i   1.0000 + 1.0000i
   2.0000 + 1.0000i   1.0000 + 1.0000i   3.0000 + 1.0000i
   1.0000 + 1.0000i   3.0000 + 1.0000i   2.0000 + 1.0000i
   1.0000 + 1.0000i   2.0000 + 1.0000i   3.0000 + 1.0000i

入力引数

v — アイテムの集合

数値、logical または char 値のベクトル

アイテムの集合。数値、logical または char 値のベクトルとして指定します。

例: [1 2 3 4]

例: [1+1i 2+1i 3+1i 4+1i]

例: int16([1 2 3 4])

例: ['abcd']

例: [true false true false]

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
複素数のサポート: あり

制限

perms(v) は、length(v) が 10 未満の場合に実際に適用できます。

詳細

置換

集合の置換とは、集合の要素のすべての可能な並べ方を示したものです。P = perms(v) は、ベクトル v の要素インデックスの逆辞書式順で v の要素を置換したものを返します。たとえば、3 要素のベクトル v では、P = perms(v) は以下と同じ出力を返します。

P = [v(3) v(2) v(1);
     v(3) v(1) v(2);
     v(2) v(3) v(1);
     v(2) v(1) v(3);
     v(1) v(3) v(2);
     v(1) v(2) v(3)]

拡張機能

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。 (R2024b 以降)

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

perms 関数は、GPU 配列を完全にサポートします。GPU 上で関数を実行するには、入力データを gpuArray (Parallel Computing Toolbox) として指定します。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。 (R2024b 以降)

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

参考

nchoosek | permute | randperm | combinations