issortedrows
行列または table の行が並べ替えされているかどうかを判別
構文
説明
TF = issortedrows(
は、行列 A
)A
の最初の列の要素が昇順でリストされている場合に、logical スカラー 1 (true
) を返します。それ以外の場合には、issortedrows
は 0 (false
) を返します。最初の列に連続して繰り返される要素がある場合、issortedrows
は次の列が昇順であるかどうかを判別し、この動作を後続の等しい値について繰り返します。
TF = issortedrows(___,
は、上記のすべての構文について、direction
)A
の最初の列が direction
で指定された順序になっている場合に 1 を返します。たとえば、issortedrows(A,'monotonic')
は A
の最初の列が昇順または降順になっているかどうかをチェックします。direction
はチェック対象の各列に対して複数の方向を表す文字ベクトルの cell 配列にすることもできます。たとえば、issortedrows(A,[2 3],{'ascend' 'descend'})
は A
の 2 番目の列が昇順になっているかどうかをチェックし、同順位の場合は次に 3 番目の列が降順になっているかどうかをチェックして、順序を決定します。
TF = issortedrows(___,
は並べ替え順序をチェックするための追加パラメーターを指定します。たとえば、Name,Value
)issortedrows(A,'ComparisonMethod','abs')
は A
の最初の列にある要素が大きさの順に並べ替えられているかどうかをチェックします。
TF = issortedrows(
は、table の行が行名に基づいて昇順になっているかどうかをチェックします。table の行名により、table の最初の次元に沿って行にラベルが設定されます。tblA
,'RowNames')
tblA
が timetable である場合、この構文はサポートされません。
TF = issortedrows(
は、table の行が最初の次元に沿って行ラベル tblA
,rowDimName
)rowDimName
の順に並べ替えられているかどうかをチェックします。
tblA
が table の場合、ラベルは行名です。tblA
が timetable の場合、ラベルは行時間です。
TF = issortedrows(___,
は、上記の table 構文のすべてについて、table が direction
)direction
で指定された順序で並べ替えられているかどうかをチェックします。direction
には 'descend'
や 'monotonic'
などの単一の並べ替え順序を設定できます。これは指定した変数、行名または行時間のそれぞれに適用されます。また、direction
は、issortedrows
の動作対象として指定した変数、行名、行時間ごとに異なる並べ替え順序を含む要素をもつ cell 配列にすることもできます。
TF = issortedrows(___,
は table を並べ替えるための追加パラメーターを指定します。たとえば、Name,Value
)issortedrows(tblA,'Var1','MissingPlacement','first')
は Var1
の欠損要素 (NaN
や NaT
など) が table の先頭に配置されていることをチェックします。
例
入力引数
拡張機能
バージョン履歴
R2017a で導入