sortrows

행렬 또는 테이블의 행 정렬

페이지 내 모두 축소

구문

B = sortrows(A)

B = sortrows(A,column)

B = sortrows(A,___,direction)

B = sortrows(A,___,Name,Value)

[B,index] = sortrows(A,___)

tblB = sortrows(tblA)

tblB = sortrows(tblA,'RowNames')

tblB = sortrows(tblA,rowDimName)

tblB = sortrows(tblA,vars)

tblB = sortrows(tblA,___,direction)

tblB = sortrows(tblA,___,Name,Value)

[tblB,index] = sortrows(tblA,___)

설명

배열 데이터

B = sortrows(A)는 첫 번째 열의 요소를 기준으로 배열의 행을 정렬합니다. 기본적으로, sortrows는 오름차순 정렬 순서를 사용합니다. 첫 번째 열에 반복된 요소가 있으면 sortrows는 다음 열의 값에 따라 정렬하고 이후에 나오는 동일한 값에 대하여 이 동작을 반복합니다.

예제

B = sortrows(A,column)은 행 정렬의 기준이 되는 열을 지정합니다. 예를 들어, sortrows(A,[4 6])은 먼저 네 번째 열의 요소를 기준으로 A의 행을 정렬한 다음, 우선 순위를 결정하기 위해 여섯 번째 열의 요소를 기준으로 정렬합니다.

예제

B = sortrows(A,___,direction)은 위에 열거된 구문에 대해 정렬 방향을 지정합니다. 예를 들어 sortrows(A,'descend')는 내림차순 정렬 순서를 사용합니다.

예제

B = sortrows(A,___,Name,Value)는 행 정렬에 대한 추가 파라미터를 지정합니다. 예를 들어, sortrows(A,'ComparisonMethod','abs')는 크기를 기준으로 A의 요소를 정렬합니다.

예제

[B,index] = sortrows(A,___)는 B = A(index,:)를 충족하는, 행의 재배열을 기술하는 인덱스 벡터도 반환합니다.

예제

테이블 데이터

tblB = sortrows(tblA)는 테이블 또는 타임테이블의 행을 정렬합니다.

tblA가 테이블인 경우 sortrows는 첫 번째 변수의 값을 기준으로 tblA를 오름차순으로 정렬합니다. 첫 번째 변수에서 요소가 반복되는 경우 sortrows는 두 번째 변수의 요소를 기준으로 정렬하며, 이러한 방식이 계속해서 적용됩니다.
tblA가 타임테이블이면 sortrows는 tblA의 행을 행 시간값을 기준으로 오름차순으로 정렬합니다. 그러나 행은 행 시간값에 대해서만 정렬됩니다. 행 시간값이 반복되는 경우 sortrows는 타임테이블 변수의 요소를 기준으로 정렬하지 않습니다.

예제

tblB = sortrows(tblA,'RowNames')는 해당 행 이름을 기준으로 테이블을 정렬합니다. 테이블의 행 이름은 테이블의 첫 번째 차원에 있는 행에 레이블을 지정합니다. tblA에 행 이름이 없는 경우 즉, tblA.Properties.RowNames가 비어 있는 경우 sortrows는 tblA를 반환합니다.

이 구문은 tblA가 타임테이블인 경우에는 지원되지 않습니다.

예제

tblB = sortrows(tblA,rowDimName)은 첫 번째 차원을 따라 행 레이블을 기준으로 정렬합니다.

tblA가 table형이면 행 레이블은 행 이름입니다.
tblA가 timetable형이면 행 레이블은 행 시간값입니다.

예제

tblB = sortrows(tblA,vars)는 지정한 테이블 변수를 기준으로 정렬합니다. 예를 들어, sortrows(tblA,{'Var1','Var2'})는 먼저 Var1의 요소를 기준으로 tblA의 행을 정렬한 다음 Var2의 요소를 기준으로 정렬합니다.

tblA가 table형이고 행 이름을 포함할 경우 vars는 행 이름을 포함할 수 있습니다.
tblA가 타임테이블인 경우 vars는 행 시간값을 포함할 수 있습니다.

예제

tblB = sortrows(tblA,___,direction)은 위에 열거된 테이블 구문에 대해 지정된 방향으로 tblA의 행을 정렬합니다.

예제

tblB = sortrows(tblA,___,Name,Value)는 테이블 또는 타임테이블의 행 정렬을 위한 추가 파라미터를 지정합니다. 예를 들어, sortrows(tblA,'Var1','MissingPlacement','first')는 Var1의 요소를 기준으로 정렬하며 누락된 요소(예: NaN)를 테이블의 시작 부분에 정렬합니다.

예제

[tblB,index] = sortrows(tblA,___)는 tblB = tblA(index,:)를 충족하는 인덱스 벡터를 반환합니다.

예제

모두 축소

행렬의 행 정렬하기

라이브 스크립트 열기

행렬을 만든 다음, 첫 번째 열의 요소를 기준으로 행렬의 행을 오름차순으로 정렬합니다. 첫 번째 열에 반복된 요소가 있으면 sortrows는 두 번째 열의 요소를 확인하여 우선 순위를 결정합니다. 두 번째 열에 반복된 요소가 있으면 sortrows는 세 번째 열의 요소를 확인하여 우선 순위를 결정하며, 이러한 방식이 계속해서 적용됩니다.

rng default;
A = floor(rand([6 7])*100);
A(1:4,1) = 95;  A(5:6,1) = 76;  A(2:4,2) = 7;  A(3,3) = 48

A = 6×7

    95    27    95    79    67    70    69
    95     7    48    95    75     3    31
    95     7    48    65    74    27    95
    95     7    14     3    39     4     3
    76    15    42    84    65     9    43
    76    97    91    93    17    82    38

B = sortrows(A)

B = 6×7

    76    15    42    84    65     9    43
    76    97    91    93    17    82    38
    95     7    14     3    39     4     3
    95     7    48    65    74    27    95
    95     7    48    95    75     3    31
    95    27    95    79    67    70    69

두 번째 열의 값을 기준으로 A 행을 정렬합니다. 지정된 열에 반복된 요소가 있으면, 이에 대응하는 행은 원래의 순서를 유지합니다.

C = sortrows(A,2)

C = 6×7

    95     7    48    95    75     3    31
    95     7    48    65    74    27    95
    95     7    14     3    39     4     3
    76    15    42    84    65     9    43
    95    27    95    79    67    70    69
    76    97    91    93    17    82    38

첫 번째 열의 요소를 기준으로 A의 행을 정렬한 다음 일곱 번째 열을 확인하여 우선 순위를 결정합니다.

D = sortrows(A,[1 7])

D = 6×7

    76    97    91    93    17    82    38
    76    15    42    84    65     9    43
    95     7    14     3    39     4     3
    95     7    48    95    75     3    31
    95    27    95    79    67    70    69
    95     7    48    65    74    27    95

네 번째 열의 요소를 기준으로 A의 행을 내림차순으로 정렬한 다음, 행이 어떻게 재배열되었는지 확인하기 위해 출력 벡터 index를 표시합니다.

[E,index] = sortrows(A,4,'descend')

E = 6×7

    95     7    48    95    75     3    31
    76    97    91    93    17    82    38
    76    15    42    84    65     9    43
    95    27    95    79    67    70    69
    95     7    48    65    74    27    95
    95     7    14     3    39     4     3

index = 6×1

     2
     6
     5
     1
     3
     4

복소수 행렬

라이브 스크립트 열기

복소수를 포함하는 행렬을 만든 다음, 첫 번째 열의 요소를 기준으로 행렬의 행을 오름차순으로 정렬합니다. A(1,1)과 A(3,1)의 크기가 같기 때문에 sortrows는 각각의 각을 계산하여 우선 순위를 결정합니다.

A = [1+2i 3+i i; 2+10i 6i 2+5i; 2+i 4 3+3i]

A = 3×3 complex

   1.0000 + 2.0000i   3.0000 + 1.0000i   0.0000 + 1.0000i
   2.0000 +10.0000i   0.0000 + 6.0000i   2.0000 + 5.0000i
   2.0000 + 1.0000i   4.0000 + 0.0000i   3.0000 + 3.0000i

B = sortrows(A)

B = 3×3 complex

   2.0000 + 1.0000i   4.0000 + 0.0000i   3.0000 + 3.0000i
   1.0000 + 2.0000i   3.0000 + 1.0000i   0.0000 + 1.0000i
   2.0000 +10.0000i   0.0000 + 6.0000i   2.0000 + 5.0000i

angle(A(1,1))

ans = 
1.1071

angle(A(3,1))

ans = 
0.4636

'real' 옵션을 사용하여 각 실수부를 기준으로 A의 행을 정렬합니다. A(2,1)과 A(3,1)의 실수부가 같기 때문에 sortrows는 허수부를 사용하여 우선 순위를 결정합니다.

C = sortrows(A,'ComparisonMethod','real')

C = 3×3 complex

   1.0000 + 2.0000i   3.0000 + 1.0000i   0.0000 + 1.0000i
   2.0000 + 1.0000i   4.0000 + 0.0000i   3.0000 + 3.0000i
   2.0000 +10.0000i   0.0000 + 6.0000i   2.0000 + 5.0000i

imag(A(2,1))

ans = 
10

imag(A(3,1))

ans = 
1

string형 배열의 행 정렬하기

라이브 스크립트 열기

6×2 string형 배열을 만듭니다. 첫 번째 열의 요소를 기준으로 행을 알파벳 오름차순으로 정렬합니다. 첫 번째 열에 반복된 요소가 있으면 두 번째 열을 사용하여 우선 순위를 결정합니다.

A = ["B" "Y"; "B" "Z"; "A" "Z"; ...
     "B" "X"; "A" "Y"; "A" "X"];
B1 = sortrows(A)

B1 = 6×2 string
    "A"    "X"
    "A"    "Y"
    "A"    "Z"
    "B"    "X"
    "B"    "Y"
    "B"    "Z"

행을 다시 정렬합니다. 이번에는 두 번째 열에 있는 요소를 알파벳 내림차순으로 정렬하여 첫 번째 열에 있는 요소에 대한 우선 순위를 결정합니다.

B2 = sortrows(A,[1 2],["ascend" "descend"])

B2 = 6×2 string
    "A"    "Z"
    "A"    "Y"
    "A"    "X"
    "B"    "Z"
    "B"    "Y"
    "B"    "X"

테이블의 행 정렬하기

라이브 스크립트 열기

변수 값을 기준으로 테이블의 행을 정렬합니다.

5명의 환자 정보를 나열하는 4개의 변수를 갖는 테이블을 만듭니다.

LastName = ["Smith";"Johnson";"Williams";"Jones";"Brown"];
Age = [38;43;38;40;49];
Height = [71;69;64;67;64];
Weight = [176;163;131;133;119];
BloodPressure = [124 93; 109 77; 125 83; 117 75; 122 80];

tblA = table(Age,Height,Weight,BloodPressure,RowNames=LastName)

tblA=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Smith       38       71       176       124     93  
    Johnson     43       69       163       109     77  
    Williams    38       64       131       125     83  
    Jones       40       67       133       117     75  
    Brown       49       64       119       122     80

테이블 행을 정렬합니다. sortrows 함수는 먼저 변수 Age를 기준으로 행을 오름차순으로 정렬한 다음, 나이가 같은 두 행 간에 우선 순위를 결정하기 위해 변수 Height를 기준으로 정렬합니다.

tblB = sortrows(tblA)

tblB=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Williams    38       64       131       125     83  
    Smith       38       71       176       124     93  
    Jones       40       67       133       117     75  
    Johnson     43       69       163       109     77  
    Brown       49       64       119       122     80

행 이름을 기준으로 테이블 행 정렬하기

라이브 스크립트 열기

5명의 환자 정보를 나열하는 4개의 변수를 갖는 테이블을 만듭니다.

LastName = ["Smith";"Johnson";"Williams";"Jones";"Brown"];
Age = [38;43;38;40;49];
Height = [71;69;64;67;64];
Weight = [176;163;131;133;119];
BloodPressure = [124 93; 109 77; 125 83; 117 75; 122 80];

tblA = table(Age,Height,Weight,BloodPressure,RowNames=LastName)

tblA=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Smith       38       71       176       124     93  
    Johnson     43       69       163       109     77  
    Williams    38       64       131       125     83  
    Jones       40       67       133       117     75  
    Brown       49       64       119       122     80

행 이름을 기준으로 테이블의 행을 오름차순으로 정렬하고 행이 어떻게 재배열되었는지 보여주는 인덱스 벡터를 반환합니다.

[tblB,index] = sortrows(tblA,"RowNames")

tblB=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Brown       49       64       119       122     80  
    Johnson     43       69       163       109     77  
    Jones       40       67       133       117     75  
    Smith       38       71       176       124     93  
    Williams    38       64       131       125     83

index = 5×1

     5
     2
     4
     1
     3

인덱스 벡터를 사용하여 원래 정렬되지 않은 테이블의 요소를 참조하고, 정렬된 순서대로 행에 액세스할 수 있습니다.

tblA(index,:)

ans=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Brown       49       64       119       122     80  
    Johnson     43       69       163       109     77  
    Jones       40       67       133       117     75  
    Smith       38       71       176       124     93  
    Williams    38       64       131       125     83

변수를 기준으로 테이블 행 정렬

라이브 스크립트 열기

5명의 환자 정보를 나열하는 4개의 변수를 갖는 테이블을 만듭니다.

LastName = ["Sweet";"Jacobson";"Wang";"Joiner";"Berger"];
Age = [38;43;38;40;49];
Height = [71;69;64;67;64];
Weight = [176;163;131;133;119];
BloodPressure = [124 93; 109 77; 125 83; 117 75; 122 80];

tblA = table(Age,Height,Weight,BloodPressure,RowNames=LastName)

tblA=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Sweet       38       71       176       124     93  
    Jacobson    43       69       163       109     77  
    Wang        38       64       131       125     83  
    Joiner      40       67       133       117     75  
    Berger      49       64       119       122     80

Height를 기준으로 테이블의 행을 오름차순으로 정렬한 다음, Weight를 기준으로 내림차순으로 정렬합니다.

tblB = sortrows(tblA,["Height" "Weight"],["ascend" "descend"])

tblB=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Wang        38       64       131       125     83  
    Berger      49       64       119       122     80  
    Joiner      40       67       133       117     75  
    Jacobson    43       69       163       109     77  
    Sweet       38       71       176       124     93

누락된 요소가 포함된 테이블

라이브 스크립트 열기

5명의 환자 정보를 나열하는 4개의 변수를 갖는 테이블을 만듭니다. Weight 변수에 누락값이 포함되어 있습니다.

LastName = ["Sweet";"Jacobson";"Wang";"Joiner";"Berger"];
Age = [38;43;38;40;49];
Height = [71;69;64;67;64];
Weight = [176;NaN;131;133;NaN];
BloodPressure = [124 93; 109 77; 125 83; 117 75; 122 80];
tblA = table(Age,Height,Weight,BloodPressure,RowNames=LastName)

tblA=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Sweet       38       71       176       124     93  
    Jacobson    43       69       NaN       109     77  
    Wang        38       64       131       125     83  
    Joiner      40       67       133       117     75  
    Berger      49       64       NaN       122     80

Weight를 기준으로 테이블의 행을 오름차순으로 정렬하되, NaN이 포함된 행을 처음에 배치합니다.

tblB = sortrows(tblA,"Weight",MissingPlacement="first")

tblB=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Jacobson    43       69       NaN       109     77  
    Berger      49       64       NaN       122     80  
    Wang        38       64       131       125     83  
    Joiner      40       67       133       117     75  
    Sweet       38       71       176       124     93

타임테이블의 행 정렬하기

라이브 스크립트 열기

타임테이블을 생성합니다.

TimeDuration = [seconds(3) seconds(2) seconds(1) seconds(5) seconds(4)]';
TT = timetable(TimeDuration,[98;97.5;97.9;98.1;101],[120;111;119;117;118])

TT=5×2 timetable
    TimeDuration    Var1    Var2
    ____________    ____    ____

    3 sec             98    120 
    2 sec           97.5    111 
    1 sec           97.9    119 
    5 sec           98.1    117 
    4 sec            101    118

타임테이블의 행 시간값을 기준으로 행을 정렬합니다.

B = sortrows(TT)

B=5×2 timetable
    TimeDuration    Var1    Var2
    ____________    ____    ____

    1 sec           97.9    119 
    2 sec           97.5    111 
    3 sec             98    120 
    4 sec            101    118 
    5 sec           98.1    117

입력 인수

모두 축소

`A` — 입력 배열
열 벡터 | 행렬

입력 배열로, 열 벡터나 행렬로 지정됩니다.

`column` — 열 정렬 벡터
0이 아닌 정수 스칼라 | 0이 아닌 정수로 구성된 벡터

열 정렬 벡터로, 0이 아닌 정수 스칼라 또는 0이 아닌 정수로 구성된 벡터로 지정됩니다. 지정된 각 정수 값은 정렬의 기준이 되는 열을 나타냅니다. 음의 정수는 정렬 순서가 내림차순임을 나타냅니다.

`direction` — 정렬 방향
`'ascend'` (디폴트 값) | `'descend'` | string형 배열 | 문자형 벡터로 구성된 셀형 배열

정렬 방향으로, 'ascend' 또는 'descend'로 지정되거나 그러한 값 조합을 지정하는 string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

direction이 'ascend' 또는 'descend'이면 해당 정렬 방향이 모든 열 정렬 벡터 또는 정렬 변수에 적용됩니다. direction이 string형 배열이거나 문자형 벡터로 구성된 셀형 배열인 경우 각 요소는 열 정렬 벡터 또는 정렬 변수에 대응됩니다.

column과 direction을 모두 지정하면 direction은 정렬 방향을 결정하고 sortrows는 column에 있는 요소의 부호를 무시합니다.

예: sortrows(X,[2 3],{'ascend' 'descend'})는 먼저 X의 열 2에 따라 오름차순으로 행을 정렬합니다. 그런 다음 열 2에 동일한 항목이 있는 행들이 열 3에 따라 내림차순으로 정렬됩니다.

`tblA` — 입력 테이블
테이블 | 타임테이블

입력 테이블로, table형 또는 timetable형으로 지정됩니다. tblA의 각 변수는 sort나 sortrows에 대한 유효한 입력값이어야 합니다.

`rowDimName` — 입력 테이블 또는 타임테이블의 첫 번째 차원 이름
string형 스칼라 | 문자형 벡터

입력 테이블 또는 타임테이블의 첫 번째 차원 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다.

tblA가 행 이름을 포함하는 테이블인 경우 rowDimName은 해당 테이블의 첫 번째 차원 이름입니다. 기본적으로, 첫 번째 차원의 이름은 "Row"입니다. 차원 이름은 테이블의 속성입니다. tblA.Properties.DimensionNames를 사용하여 tblA의 차원 이름에 액세스할 수 있습니다.
tblA가 타임테이블인 경우 rowDimName은 행 시간값으로 구성된 벡터 이름입니다. Time 또는 Date와 같이 타임테이블을 만들 때 이름을 지정할 수 있습니다. 또한 tblA.Properties.DimensionNames를 사용하여 차원 이름에 액세스할 수도 있습니다.

예: 테이블 T에 행 이름이 포함되어 있으며 T.Properties.DimensionName{1} = "Name"을 사용하여 첫 번째 차원 이름을 변경한 경우, sortrows(T,"Name")은 행 이름을 기준으로 테이블을 정렬합니다.

예: 타임테이블 TT에 Date라는 이름의 시간 벡터가 있으면 sortrows(TT,"Date")는 Date에 포함된 날짜와 시간에 따라 타임테이블을 정렬합니다.

데이터형: string | char

`vars` — 정렬을 위한 변수
정수 스칼라 | 정수 벡터 | 변수 이름 | 변수 이름으로 구성된 string형 배열 | 변수 이름으로 구성된 셀형 배열 | `pattern`형 스칼라 | 논리형 벡터

정렬을 위한 변수로, 정수 스칼라, 정수로 구성된 벡터, 변수 이름, 변수 이름으로 구성된 string형 배열, 변수 이름으로 구성된 셀형 배열, pattern 스칼라 또는 논리형 벡터로 지정됩니다. vars는 정렬할 때 기준으로 삼을 테이블 변수를 나타냅니다.

direction 인수를 지정하지 않으면 vars에 있는 요소의 부호에 따라 변수의 정렬 방향이 결정됩니다. 요소가 양수인 경우, sortrows는 tblA의 해당 변수를 오름차순으로 정렬합니다. 요소가 음수인 경우, sortrows는 tblA의 해당 변수를 내림차순으로 정렬합니다. 그러지 않고 direction 인수를 지정하면 sortrows는 vars의 부호를 무시하고 direction에 따라 지정된 변수를 정렬합니다.

예: sortrows(tblA,["Height","Weight"])는 먼저 변수 Height를 기준으로 tblA의 행을 오름차순으로 정렬한 다음, 우선 순위를 결정하기 위해 변수 Weight를 기준으로 정렬합니다.

예: sortrows(tblA,"X" + wildcardPattern)은 이름의 나머지 문자와 일치시키는 와일드카드 패턴을 사용하여 이름이 영문자 "X"로 시작하는 테이블 변수를 기준으로 tblA의 행을 오름차순으로 정렬합니다.

예: sortrows(tblA,[1 4])는 tblA의 첫 번째 변수를 기준으로 오름차순으로 정렬한 다음, 우선 순위를 결정하기 위해 네 번째 변수를 기준으로 정렬합니다.

예: sortrows(TT,["Time","X"])는 먼저 타임테이블 TT의 행 시간값을 오름차순으로 정렬한 다음, 우선 순위를 결정하기 위해 테이블 변수 X를 기준으로 정렬합니다.

이름-값 인수

모두 축소

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: sortrows(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의 행을 정렬하고, A가 복소수인 경우 abs(A)를 기준으로 정렬합니다.
'real' — A가 실수이거나 복소수인 경우 real(A)를 기준으로 A의 행을 정렬합니다. A의 열에 실수부가 동일한 요소가 있는 경우, imag(A)를 사용하여 우선 순위를 결정합니다.
'abs' — A가 실수이거나 복소수인 경우 abs(A)를 기준으로 A의 행을 정렬합니다. A의 열에 크기가 동일한 요소가 있는 경우, 구간 (-π,π]에서의 angle(A)를 사용하여 우선 순위를 결정합니다.

출력 인수

모두 축소

`B` — 정렬된 배열
열 벡터 | 행렬

정렬된 배열로, 열 벡터 또는 행렬로 반환됩니다. B는 A와 크기가 동일합니다.

`tblB` — 정렬된 테이블
테이블 | 타임테이블

정렬된 테이블로, tblA와 동일한 변수를 가진 테이블이나 타임테이블로 반환됩니다.

`index` — 정렬 인덱스
열 벡터

정렬 인덱스로, 열 벡터로 반환됩니다. 정렬 인덱스를 보면 입력값의 행이 어떻게 재배열되었는지 알 수 있습니다(B = A(index,:)).

sortrows 함수는 안정적인 정렬 알고리즘을 사용합니다. 따라서 입력값이 반복 값을 포함하는 경우 정렬 인덱스는 정렬 방향과 관계없이 입력값의 원래 순서를 유지합니다. 예를 들어, A = [1 1; 2 2; 1 2; 2 2]이면 [Ba,Ia] = sortrows(A,'ascend')는 정렬 인덱스 Ia = [1; 3; 2; 4]를 반환하고 [Bd,Id] = sortrows(A,'descend')는 정렬 인덱스 Id = [2; 4; 3; 1]을 반환합니다.

데이터형: double

확장 기능

모두 확장

tall형 배열
메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

sortrows 함수는 tall형 배열을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

행 이름을 기준으로 정렬하는 것은 지원되지 않습니다.

자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성
MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

셀형 또는 string형 입력 배열은 지원되지 않습니다.
A가 허수부가 모두 0인 복소수인 경우 MATLAB^®은 sortrows(A)를 호출하기 전에 A를 real(A)로 변환할 수 있습니다. 이 경우 MATLAB은 real(A)를 기준으로 A의 행을 정렬하지만, 생성된 코드는 abs(A)를 기준으로 A의 행을 정렬합니다. 생성된 코드가 MATLAB과 일치하도록 하려면 sortrows(real(A)) 또는 sortrows(A,'ComparisonMethod','real')을 사용하십시오. Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder) 항목을 참조하십시오.
tblA가 테이블이거나 타임테이블이면 입력 인수 vars는 상수여야 합니다.
tblA가 테이블이거나 타임테이블이고, 그 변수가 문자열 벡터로 구성된 셀형 배열로서 여러 개의 열을 가질 경우, 이 변수에 있는 값을 사용하여 tblA를 정렬할 수 없습니다.
vars 입력 인수는 패턴 표현식을 지원하지 않습니다.

GPU 코드 생성
GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

첫 번째 입력 인수는 셀형 배열일 수 없습니다.
A가 허수부가 모두 0인 복소수인 경우 MATLAB은 sortrows(A)를 호출하기 전에 A를 real(A)로 변환할 수 있습니다. 이 경우 MATLAB은 real(A)를 기준으로 A의 행을 정렬하지만, 생성된 코드는 abs(A)를 기준으로 A의 행을 정렬합니다. 생성된 코드가 MATLAB과 일치하도록 하려면 sortrows(real(A)) 또는 sortrows(A,'ComparisonMethod','real')을 사용하십시오.

스레드 기반 환경
MATLAB®의 `backgroundPool`을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 `ThreadPool`을 사용해 코드 실행 속도를 높일 수 있습니다.

sortrows 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열
Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

sortrows 함수는 GPU 배열 입력값을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

셀형 배열은 정렬할 수 없습니다.
희소 형식 입력값은 지원되지 않습니다.

자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열
Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

sortrows 함수는 분산 배열을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

셀형 배열은 정렬할 수 없습니다.
table형, timetable형, datetime형 및 duration형 입력값은 지원되지 않습니다.

자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

모두 확장

R2026a: 8비트 및 16비트 정수 정렬 변수의 성능이 향상됨

sortrows 함수가 int8형, uint8형, int16형 또는 uint16형의 정렬 변수를 사용하여 행을 정렬할 때의 성능이 향상되었습니다. 정렬할 행 개수가 많을수록 성능 향상이 더욱 두드러집니다.

예를 들어, 다음 코드는 int8형 변수를 기준으로 10,000,000행 테이블을 정렬합니다. 이 코드는 이전 릴리스보다 약 2.8배 빠릅니다.

function timingTest
A = randi(intmax("int8"),[1e7 1],"int8");
B = rand([1e7 1]);
T = table(A,B);
S = @() sortrows(T,"A");
t = timeit(S)
end

대략적인 실행 시간은 다음과 같습니다.

R2025b: 1.22s

R2026a: 0.44s

코드 실행 시간은 Windows^® 11, AMD EPYC™ 74F3 24-Core Processor @ 3.19GHz 테스트 시스템에서 timingTest 함수를 호출하여 측정했습니다.

참고 항목

issortedrows | sort | issorted | topkrows

sortrows

구문

설명

배열 데이터

테이블 데이터

예제

행렬의 행 정렬하기

복소수 행렬

string형 배열의 행 정렬하기

테이블의 행 정렬하기

행 이름을 기준으로 테이블 행 정렬하기

변수를 기준으로 테이블 행 정렬

누락된 요소가 포함된 테이블

타임테이블의 행 정렬하기

입력 인수

A — 입력 배열 열 벡터 | 행렬

column — 열 정렬 벡터 0이 아닌 정수 스칼라 | 0이 아닌 정수로 구성된 벡터

direction — 정렬 방향 'ascend' (디폴트 값) | 'descend' | string형 배열 | 문자형 벡터로 구성된 셀형 배열

tblA — 입력 테이블 테이블 | 타임테이블

rowDimName — 입력 테이블 또는 타임테이블의 첫 번째 차원 이름 string형 스칼라 | 문자형 벡터

vars — 정렬을 위한 변수 정수 스칼라 | 정수 벡터 | 변수 이름 | 변수 이름으로 구성된 string형 배열 | 변수 이름으로 구성된 셀형 배열 | pattern형 스칼라 | 논리형 벡터

이름-값 인수

MissingPlacement — 누락값의 배치 'auto' (디폴트 값) | 'first' | 'last'

ComparisonMethod — 요소 비교 방법 'auto' (디폴트 값) | 'real' | 'abs'

출력 인수

B — 정렬된 배열 열 벡터 | 행렬

tblB — 정렬된 테이블 테이블 | 타임테이블

index — 정렬 인덱스 열 벡터

확장 기능

tall형 배열 메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

C/C++ 코드 생성 MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

GPU 코드 생성 GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

스레드 기반 환경 MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

GPU 배열 Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

분산 배열 Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

버전 내역

R2026a: 8비트 및 16비트 정수 정렬 변수의 성능이 향상됨

참고 항목

`A` — 입력 배열
열 벡터 | 행렬

`column` — 열 정렬 벡터
0이 아닌 정수 스칼라 | 0이 아닌 정수로 구성된 벡터

`direction` — 정렬 방향
`'ascend'` (디폴트 값) | `'descend'` | string형 배열 | 문자형 벡터로 구성된 셀형 배열

`tblA` — 입력 테이블
테이블 | 타임테이블

`rowDimName` — 입력 테이블 또는 타임테이블의 첫 번째 차원 이름
string형 스칼라 | 문자형 벡터

`vars` — 정렬을 위한 변수
정수 스칼라 | 정수 벡터 | 변수 이름 | 변수 이름으로 구성된 string형 배열 | 변수 이름으로 구성된 셀형 배열 | `pattern`형 스칼라 | 논리형 벡터

`MissingPlacement` — 누락값의 배치
`'auto'` (디폴트 값) | `'first'` | `'last'`

`ComparisonMethod` — 요소 비교 방법
`'auto'` (디폴트 값) | `'real'` | `'abs'`

`B` — 정렬된 배열
열 벡터 | 행렬

`tblB` — 정렬된 테이블
테이블 | 타임테이블

`index` — 정렬 인덱스
열 벡터

tall형 배열
메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

C/C++ 코드 생성
MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

GPU 코드 생성
GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

스레드 기반 환경
MATLAB®의 `backgroundPool`을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 `ThreadPool`을 사용해 코드 실행 속도를 높일 수 있습니다.

GPU 배열
Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

분산 배열
Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.