sort

B = sort(A) は A の要素を昇順に並べ替えます。

A がベクトルの場合、sort(A) はベクトル要素を並べ替えます。
A が行列の場合、sort(A) は A の列をベクトルとして扱い、各列を並べ替えます。
A が多次元配列の場合、sort(A) は、サイズが 1 でない最初の配列次元に対して作用します。ここでは要素をベクトルとして扱います。

B = sort(A,dim) は、次元 dim に沿って並べ替えられた A の要素を返します。たとえば、A が行列である場合、sort(A,2) は各行の要素を並べ替えます。

B = sort(___,direction) は、前述の構文のいずれかを使って direction で指定された順序で並べ替えた A の要素を返します。'ascend' は昇順 (既定) を示し、'descend' は降順を示します。

B = sort(___,Name,Value) は並べ替えのための追加パラメーターを指定します。たとえば、sort(A,'ComparisonMethod','abs') は A の要素を大きさの順に並べ替えます。

[B,I] = sort(___) は、前述の任意の構文でインデックスベクトルの集合も返します。I は A と同じサイズで、並べ替えられた次元に沿った A の要素の B への配置を示します。たとえば、A がベクトルの場合、B = A(I) です。

例

ベクトルを昇順に並べ替え

行ベクトルを作成してその要素を昇順に並べ替えます。

A = [9 0 -7 5 3 8 -10 4 2];
B = sort(A)

B = 1×9

   -10    -7     0     2     3     4     5     8     9

行列の行を昇順に並べ替え

行列を作成してその各行を昇順に並べ替えます。

A = [3 6 5; 7 -2 4; 1 0 -9]

A = 3×3

     3     6     5
     7    -2     4
     1     0    -9

B = sort(A,2)

B = 3×3

     3     5     6
    -2     4     7
    -9     0     1

行列の列を降順に並べ替え

行列を作成してその列を降順に並べ替えます。

A = [10 -12 4 8; 6 -9 8 0; 2 3 11 -2; 1 1 9 3]

A = 4×4

    10   -12     4     8
     6    -9     8     0
     2     3    11    -2
     1     1     9     3

B = sort(A,'descend')

B = 4×4

    10     3    11     8
     6     1     9     3
     2    -9     8     0
     1   -12     4    -2

string 配列の並べ替え

R2017a 以降、二重引用符を使用して string 配列を作成し、関数 sort を使用して並べ替えられるようになりました。Unicode® の辞書順に従って string 配列の各列にある文字列を並べ替えます。

A = ["Santos","Burns"; ...
     "Jones","Morita"; ...
     "Petrov","Adams"];
B = sort(A)

B = 3x2 string
    "Jones"     "Adams" 
    "Petrov"    "Burns" 
    "Santos"    "Morita"

各行の string を並べ替えます。

B = sort(A,2)

B = 3x2 string
    "Burns"    "Santos"
    "Jones"    "Morita"
    "Adams"    "Petrov"

`datetime` 配列の並べ替えとインデックス付け

datetime 値の配列を作成し、昇順で古い日付から新しい日付に並べ替えます。

ds = {'2012-12-22';'2063-04-05';'1992-01-12'};
A = datetime(ds,'Format','yyyy-MM-dd')

A = 3x1 datetime
   2012-12-22
   2063-04-05
   1992-01-12

[B,I] = sort(A)

B = 3x1 datetime
   1992-01-12
   2012-12-22
   2063-04-05

B は、並べ替えられた日付を一覧表示し、I は、対応する A のインデックスを含みます。

並べ替えた要素に元の配列から直接アクセスするには、インデックス配列 I を使用します。

A(I)

ans = 3x1 datetime
   1992-01-12
   2012-12-22
   2063-04-05

3 次元配列の並べ替え

2 x 2 x 2 の配列を作成し、要素を 3 番目の次元に沿って昇順に並べ替えます。

A(:,:,1) = [2 3; 1 6];
A(:,:,2) = [-1 9; 0 12];
A

A = 
A(:,:,1) =

     2     3
     1     6


A(:,:,2) =

    -1     9
     0    12

B = sort(A,3)

B = 
B(:,:,1) =

    -1     3
     0     6


B(:,:,2) =

     2     9
     1    12

A のすべての要素を並べ替えるには、A の列表現 A(:) を使用します。

B = sort(A(:))

複素数ベクトル

複素数ベクトルの要素を、実数部で並べ替えます。実数部が等しい要素については、sort は虚数部を基準として並べ替え順序を決定します。

A = [1+2i 3+i i 0 -i];
B = sort(A,'ComparisonMethod','real')

B = 1×5 complex

   0.0000 - 1.0000i   0.0000 + 0.0000i   0.0000 + 1.0000i   1.0000 + 2.0000i   3.0000 + 1.0000i

入力引数

`A` — 入力配列
ベクトル | 行列 | 多次元配列

入力配列。ベクトル、行列または多次元配列として指定します。

A がスカラーの場合、sort(A) は A を返します。
A が複素数の場合、sort は既定では要素を大きさの順に並べ替えます。大きさの等しい要素が複数ある場合、区間 (−π, π] で位相角の順にこれらの要素を並べ替えます。
A が文字ベクトルの cell 配列または string 配列の場合、sort(A) は UTF-16 文字エンコードスキームのコードの順序に従って要素を並べ替えます。並べ替えでは大文字小文字が区別されます。文字配列と string 配列の並べ替えの詳細については、文字配列と string 配列の並べ替え順序を参照してください。
A が string 配列の場合、sort は配列の要素を並べ替えますが、string 内の文字は並べ替えません。
A が categorical 配列の場合、並べ替え順序は categories(A) によって返されるカテゴリの順序に基づきます。

`dim` — 演算の対象の次元
正の整数スカラー

演算の対象の次元。正の整数のスカラーとして指定します。値を指定しない場合、既定値は、サイズが 1 ではない最初の配列の次元です。

行列 A を考えます。sort(A,1) は A の列の要素を並べ替えます。
sort(A,2) は A の行の要素を並べ替えます。

dim が ndims(A) より大きい場合、sort は A を返します。A が cell 配列の場合、dim はサポートされないため、sort はサイズが 1 でない最初の配列の次元のみに沿って動作します。

`direction` — 並べ替える方向
`'ascend'` (既定値) | `'descend'`

並べ替える方向。'ascend' または 'descend' として指定します。A が cell 配列の場合、direction はサポートされないため、sort は昇順でのみ並べ替えを実行します。

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例: sort(A,'MissingPlacement','last')

`'MissingPlacement'` — 欠損値の配置
`'auto'` (既定値) | `'first'` | `'last'`

欠損値 (NaN、NaT、<undefined>、missing) の配置。'MissingPlacement' と、次のいずれかで構成されるコンマ区切りのペアとして指定します。

'auto' — 欠損値の要素は、昇順では最後、降順では最初に配置されます。
'first' — 欠損値の要素は最初に配置されます。
'last' — 欠損値の要素は最後に配置されます。

`'ComparisonMethod'` — 要素の比較方法
`'auto'` (既定値) | `'real'` | `'abs'`

要素の比較方法。'ComparisonMethod' と以下のいずれかで構成される、コンマ区切りペアとして指定します。

'auto' — A が実数の場合は real(A) によって、A が複素数の場合は abs(A) を基準にして A を並べ替えます。
'real' — A が実数または複素数の場合に、real(A) を基準にして A を並べ替えます。A の要素の実数部が等しい場合、imag(A) を使用して同順位のものを並べ替えます。
'abs' — A が実数または複素数の場合に、abs(A) を基準にして A を並べ替えます。A の要素の大きさが等しい場合、区間 (-π,π] で angle(A) を使用して同順位のものを並べ替えます。

出力引数

`B` — 並べ替えられた配列
ベクトル | 行列 | 多次元配列

並べ替えられた配列。ベクトル、行列または多次元配列として返されます。B のサイズと型は A と同じです。A に等しい並べ替え順序の要素があった場合、それらの並び順は B でも保持されます。

`I` — 並べ替えインデックス
ベクトル | 行列 | 多次元配列

並べ替えインデックス。ベクトル、行列または多次元配列として返されます。I のサイズは A と同じです。インデックスベクトルは sort が作用する次元に沿って方向付けされます。たとえば、A が 2 行 3 列の行列である場合、[B,I] = sort(A,2) は A の各行の要素を並べ替えます。出力 I は 1 行 3 列の行インデックスベクトルの集合で、A の各行の並べ替えを表しています。

詳細