sort

按升序或降序对实数值 fi 对象的元素进行排序

全页折叠

语法

B = sort(A)
B = sort(A,dim)
B = sort(___,direction)
[B,I] = sort(___)

说明

B = sort(A) 按升序对实数值 fi 对象 A 的元素进行排序。

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

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

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

示例

B = sort(A,dim) 返回 A 沿维度 dim 的排序元素。

示例

B = sort(___,direction) 按照 direction 指定的顺序返回 A 的排序元素。

示例

[B,I] = sort(___) 还会为上述任意语法返回一个索引向量的集合。

示例

示例

全部折叠

创建一个 fi 行向量，并按升序对其元素进行排序。

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

   -10    -7     0     2     3     4     5     8     9

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 11

创建一个由 fi 值组成的矩阵，并按降序对其列进行排序。

A = fi([10 -12 4 8; 6 -9 8 0; 2 3 11 -2; 1 1 9 3]);
B = sort(A,'descend')
B = 

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

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 11

创建一个由 fi 值组成的矩阵，并按升序对其每行进行排序。

A = fi([3 6 5; 7 -2 4; 1 0 -9]);
[B,I] = sort(A,2)
B = 

     3     5     6
    -2     4     7
    -9     0     1

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 11

I =

  3×3 int32 matrix

   1   3   2
   2   3   1
   3   2   1

B 包含已排序的值，而 I 是 1×3 行索引向量的集合，用于描述 A 中每行元素的重新排列。

输入参数

全部折叠

输入数组，指定为实数值 fi 对象。

  • 如果 A 是一个标量，则 sort(A) 返回 A。

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

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

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

sort 不支持复数定点输入或 Name,Value 参量对组。有关详细信息，请参考 MATLAB® sort 参考页。

数据类型: fi

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

维度参量必须为内置数据类型；它不能为 fi 对象。

示例: 假定有矩阵 A。sort(A,1) 对 A 的列元素进行排序。

示例: sort(A,2) 对 A 的行元素进行排序。

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

排序方向，指定为 'ascend' 或 'descend'。

数据类型: char

输出参量

全部折叠

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

排序索引，以标量、向量、矩阵或多维数组的形式返回。I 的大小与 A 相同。这些索引向量沿 sort 作用于的同一维度指定方向。

示例: 如果 A 是向量，则 B = A(I)。

示例: 如果 A 是一个 2×3 矩阵，则 [B,I] = sort(A,2) 对 A 中的每行元素进行排序。输出 I 是 1×3 行索引向量的集合，用于描述 A 中每行元素的重新排列。

扩展功能

全部展开

版本历史记录

在 R2008b 中推出

另请参阅

主题