本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

sort

对数组元素排序

说明

示例

B = sort(A) 按升序对 A 的元素进行排序。

  • 如果 A 是向量,则 sort(A) 对向量元素进行排序。

  • 如果 A 是矩阵,则 sort(A) 会将 A 的列视为向量并对每列进行排序。

  • 如果 A 是多维数组,则 sort(A) 会沿大小不等于 1 的第一个数组维度计算,并将这些元素视为向量。

示例

B = sort(A,dim) 返回 A 沿维度 dim 的排序元素。例如,如果 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

从 R2017a 开始,您可以使用双引号创建字符串数组,并使用 sort 函数对它们进行排序。根据 Unicode® 字典顺序对字符串数组的每一列中的字符串进行排序。

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

对每一行中的字符串进行排序。

B = sort(A,2)
B = 3x2 string array
    "Burns"    "Santos"
    "Jones"    "Morita"
    "Adams"    "Petrov"

创建一个由 datetime 值构成的数组,然后按升序排序,也就是从最早到最近的日历日期排序。

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

[B,I] = sort(A)
B = 3x1 datetime array
   1992-01-12
   2012-12-22
   2063-04-05

I = 3×1

     3
     1
     2

B 列出排序后的日期以及包含 A 的相应索引的 I

使用索引数组 I 从原始数组直接访问排序后的元素。

A(I)
ans = 3x1 datetime array
   1992-01-12
   2012-12-22
   2063-04-05

创建一个 2×2×2 数组,并沿第三维度按升序对元素进行排序。

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(:))
B = 8×1

    -1
     0
     1
     2
     3
     6
     9
    12

按复数向量元素的实部对元素进行排序。对于具有相等实部的元素,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 是一个标量,则 sort(A) 返回 A

  • 如果 A 是复数,默认情况下,sort 会按模对元素进行排序。如果有多个元素具有相等的模,则按区间 (−π, π] 上的相位角对这些元素进行排序。

  • 如果 A 是字符向量元胞数组或字符串数组,则 sort(A) 按照 UTF-16 字符编码方案的代码顺序对元素进行排序。排序区分大小写。有关对字符和字符串数组进行排序的详细信息,请参阅字符和字符串数组的排序顺序

  • 如果 A 是字符串数组,则 sort 将对数组元素重新排序,但不会对字符串中的字符重新排序。

  • 如果 A 是分类数组,则排序顺序基于 categories(A) 返回的类别顺序。

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | cell | categorical | datetime | duration
复数支持:

沿其运算的维度,指定为正整数标量。如果未指定值,则默认值是大小不等于 1 的第一个数组维度。

  • 假定有矩阵 Asort(A,1)A 的列元素进行排序。

  • sort(A,2)A 的行元素进行排序。

如果 dim 大于 ndims(A)sort 将返回 A。当 A 是元胞数组时,不支持 dim,即,sort 仅沿其大小不等于 1 的第一个数组维度进行运算。

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

排序方向,指定为 'ascend''descend'。当 A 是元胞数组时,不支持 direction,即,sort 仅按升序排序。

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

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

缺失值(NaNNaT<undefined>missing)的位置,指定为逗号分隔的对组,包含 'MissingPlacement' 和下列项之一:

  • 'auto' - 缺失的元素放在最后(对于升序排序)或放在最前面(对于降序排序)。

  • 'first' - 缺失的元素放在最前面。

  • 'last' - 缺失的元素放在最后。

元素比较方法,指定为逗号分隔的对组,包含 'ComparisonMethod' 和下列项之一:

  • 'auto' - 当 A 为实数时,按 real(A)A 进行排序;当 A 为复数时,按 abs(A) 进行排序。

  • 'real' - 当 A 为实数或复数时,按 real(A)A 进行排序。如果 A 包含具有相等实部的元素,则使用 imag(A) 进行排序。

  • 'abs' - 当 A 为实数或复数时,按 abs(A)A 进行排序。如果 A 包含具有相等模的元素,则使用区间 (-π,π] 中的 angle(A) 进行排序。

输出参数

全部折叠

已排序数组,以向量、矩阵或多维数组的形式返回。B 的大小和类型均与 A 相同。B 中元素的顺序会保留 A 中任何相等元素的顺序。

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | cell | categorical | datetime | duration

排序索引,以向量、矩阵或多维数组的形式返回。I 的大小与 A 相同。这些索引向量沿 sort 作用于的同一维度指定方向。例如,如果 A 是一个 2×3 矩阵,则 [B,I] = sort(A,2)A 中的每行元素进行排序。输出 I 是 1×3 行索引向量的集合,用于描述 A 中每行元素的重新排列。

详细信息

全部折叠

字符和字符串数组的排序顺序

MATLAB® 使用 UTF-16 字符编码方案将字符存储为 Unicode®。字符和字符串数组按 UTF-16 代码点顺序进行排序。对于同时也是 ASCII 字符的字符,此顺序意味着大写字母在小写字母之前。数字和某些标点符号也在字母之前。

提示

  • sortrows 函数提供了额外的灵活性,可基于矩阵或表输入的多列进行子排序。

  • sort 函数和关系运算符对复数使用不同顺序。有关详细信息,请参阅关系运算

扩展功能

在 R2006a 之前推出