sort

Syntax

s = sort(x)

s = sort(x)

s = sort(x, dim)

s = sort(x, 'ascend')

s = sort(x, 'descend')

s = sort(x, dim, 'ascend')

s = sort(x, dim, 'descend')

[s, idx] = sort(...)

Inputs

x

A matrix, an array of char, or a cell.

Type: double | integer | char | string | logical | struct | cell

Dimension: scalar | string | vector | matrix

dim

The dimension on which to sort

Default: first non-singleton dimension.

Type: integer

Dimension: scalar

Outputs

s

Sorted elements.

idx

Index vector such that s = x(idx).

Examples

One output with default dimension and direction input:

R = sort([4,3,2,1])

R = [Matrix] 1 x 4
1 2 3 4

Two outputs with default dimension and direction:

[s,idx]=sort([4,3,2,1])

s = [ 1 2 3 4 ]
idx = [ 4 3 2 1 ]

Two outputs with ascend specified:

[s,idx]=sort([1,2,3,4],'ascend')

s = [ 1 2 3 4 ]
idx = [ 1 2 3 4 ]

Two outputs with dim and descend specified:

[s,idx]=sort([4,3,2,1;3,6,1,2;2,2,2,1],2,'descend')

s = [ 4 3 2 1 ; 6 3 2 1 ; 2 2 2 1 ]
idx = [ 1 2 3 4 ; 2 1 4 3 ; 1 2 3 4 ]

Comments

The default sort direction is ascend.

NaN values are sorted to the high end of the list, as if they are greater than all other values, including inf.