issorted

确定数组是否已排序

全页折叠

语法

TF = issorted(A)
TF = issorted(A,dim)
TF = issorted(___,direction)
TF = issorted(___,Name,Value)
TF = issorted(A,'rows')

说明

当 A 的元素按排序顺序排列时，TF = issorted(A) 返回逻辑值 1 (true)，否则返回逻辑值 0 (false)。

  • 如果 A 是向量，当向量元素按升序排序时，issorted 将返回 1。

  • 如果 A 是矩阵，当 A 的每一列按升序排序时，issorted 将返回 1。

  • 如果 A 是多维数组，当 A 沿其大小不等于 1 的第一个维度按升序排序时，issorted 将返回 1。

  • 如果 A 是时间表，当其行时间向量按升序排序时，issorted 将返回 1。要检查行时间或包含更多选项的时间表变量的排序顺序，请使用 issortedrows 函数。

示例

当 A 沿维度 dim 排序时，TF = issorted(A,dim) 将返回 1。例如，如果 A 是矩阵，当 A 的每一行按升序排序时，issorted(A,2) 将返回 1。

示例

当 A 按 direction 指定的顺序排序时，TF = issorted(___,direction) 将为上述任何语法返回 1。例如，如果 issorted(A,'monotonic') 的元素是升序或降序排序，则 A 返回 1。

示例

TF = issorted(___,Name,Value) 指定用于检查排序顺序的其他参数。例如，issorted(A,'ComparisonMethod','abs') 检查 A 是否按模排序。

示例

当矩阵第一列的元素按顺序排列时，TF = issorted(A,'rows') 将返回 1。如果第一列包含重复元素，issorted 将根据第二列的排序方式来确定 TF。通常，如果当前列和前面的列都包含重复元素，issorted 将根据右侧紧邻的那一列来确定 TF。

  • 如果 A 是时间表，则 issorted 检查行时间向量是否按升序排列。

  • 对于字符向量矩阵，不支持此语法。

注意

不建议使用该语法。请改用 issortedrows。

示例

全部折叠

打开实时脚本

创建一个向量，并检查它是否按升序排序。

A = [5 12 33 39 78 90 95 107];
issorted(A)
ans = logical
   1
打开实时脚本

创建一个 5×5 矩阵，并检查其中的每一行是否按降序排序。

A = magic(5)
A = 5×5

    17    24     1     8    15
    23     5     7    14    16
     4     6    13    20    22
    10    12    19    21     3
    11    18    25     2     9


issorted(A,2,'descend')
ans = logical
   0

使用 sort 函数对 A 的每一行按降序排序，并检查结果是否具有降序排列的行。

B = sort(A,2,'descend')
B = 5×5

    24    17    15     8     1
    23    16    14     7     5
    22    20    13     6     4
    21    19    12    10     3
    25    18    11     9     2


issorted(B,2,'descend')
ans = logical
   1
打开实时脚本

创建一个二维字符串数组，并确定每一列是否已排序。 

str = ["Horse","Chicken";"cow","Goat"]
str = 2×2 string
    "Horse"    "Chicken"
    "cow"      "Goat"   


issorted(str)
ans = logical
   1

确定各行是否已从左到右进行排序。

issorted(str,2)
ans = logical
   0

确定每一行是否已按降序从左到右进行排序。

issorted(str,2,'descend')
ans = logical
   1
打开实时脚本

创建一个包含复数和 NaN 值的向量。

A = [NaN NaN 1+i 1+2i 2+2i 3+i];

检查 NaN 元素是否放置在向量的最前面，其余元素是否按实部进行排序。

issorted(A,'MissingPlacement','first','ComparisonMethod','real')
ans = logical
   1

由于 A 的第三个和第四个元素具有相等的实部，issorted 会检查这些元素的虚部是否也已排序。

imag(A(3))
ans = 
1

imag(A(4))
ans = 
2

输入参数

全部折叠

输入数组，指定为向量、矩阵、多维数组、字符向量元胞数组或时间表。

  • 如果 A 包含缺失值，例如 NaN、NaT、<undefined> 和 missing，则默认情况下，issorted 只在这些值位于末尾位置时才会返回 1。

  • 如果 A 为复数，则默认情况下，issorted 基于元素的模确定排序顺序。如果存在具有相等模的连续元素，则 issorted 还检查区间 (-π, π] 中的相位角以进行排序。

  • 如果 A 为字符向量元胞数组或字符串数组，则 issorted 基于 UTF-16 字符编码方案的代码顺序确定排序顺序。排序区分大小写。有关已排序字符和字符串数组的详细信息，请参阅字符和字符串数组的排序顺序。

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

复数支持: 是

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

考虑矩阵 A。issorted(A,1) 会检查 A 的每列中的数据是否已排序。

issorted(A,1) column-wise computation.

issorted(A,2) 会检查 A 中每一行的数据是否已排序。

issorted(A,2) row-wise computation.

时间表输入不支持 dim。

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

排序方向，指定为以下值之一：

  • 'ascend' - 检查数据是否按升序排列。数据可以包含连续的重复元素。

  • 'descend' - 检查数据是否按降序排列。数据可以包含连续的重复元素。

  • 'monotonic' - 检查数据是否按降序或升序排列。数据可以包含连续的重复元素。

  • 'strictascend' - 检查数据是否严格地按升序排列。数据不能包含重复元素或缺失元素。

  • 'strictdescend' - 检查数据是否严格地按降序排列。数据不能包含重复元素或缺失元素。

  • 'strictmonotonic' - 检查数据是否严格地按降序或升序排列。数据不能包含重复元素或缺失元素。

时间表输入不支持 direction。请改用 issortedrows。

名称-值参数

全部折叠

以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

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

缺失值（NaN、NaT、<undefined> 和 missing）的位置，指定为逗号分隔的对组，包含 'MissingPlacement' 和下列项之一：

  • 'auto' - 缺失的元素必须放在最后（对于升序排序）或放在最前面（对于降序排序），才会返回 1。

  • 'first' - 缺失的元素必须放在最前面，才会返回 1。

  • 'last' - 缺失的元素必须放在最后，才会返回 1。

时间表输入不支持这种名称-值对组。请改用 issortedrows。

数值输入的元素比较方法，指定为逗号分隔的对组，包含 'ComparisonMethod' 和下列项之一：

  • 'auto' - 当 A 为实数时，检查 A 是否按 real(A) 排序，当 A 为复数时，检查 A 是否按 abs(A) 排序。

  • 'real' - 当 A 为实数或复数时，检查 A 是否按 real(A) 排序。如果 A 的元素具有连续相等的实部，则检查 imag(A) 以进行排序。

  • 'abs' - 当 A 为实数或复数时，检查 A 是否按 abs(A) 排序。如果 A 的元素具有连续相等的模，则检查区间 (-π,π] 中的 angle(A) 以进行排序。

详细信息

全部折叠

扩展功能

全部展开

版本历史记录

在 R2006a 之前推出

另请参阅

| |