sort

Ordena os elementos de um array em ordem crescente ou decrescente.

Categoria: Language Fundamentals > Matrices and Arrays

Sintaxe

B = sort(A)

Ordena em ordem crescente ao longo da primeira dimensão de tamanho diferente de 1.

B = sort(A, dim)

Ordena ao longo da dimensão dim.

B = sort(___, direction)

'ascend' (padrão) ou 'descend'.

[B, I] = sort(___)

Também retorna os índices que levam A a B.

Descrição

Em uma matriz, cada coluna é ordenada separadamente; use sort(A, 2) para ordenar cada linha. A ordenação é estável, então elementos iguais mantêm a ordem relativa original, e I diz de onde cada elemento veio. Valores NaN ficam por último em ordem crescente e primeiro em ordem decrescente. Números complexos são ordenados pelo módulo e depois pela fase. Texto é ordenado pelo código do caractere, então maiúsculas vêm antes de minúsculas.

Para ordenar linhas inteiras por uma coluna, use sortrows.

Argumentos de entrada

A
Array numérico, lógico, char, string, categorical ou datetime, ou cell array de vetores de caracteres.
dim
Dimensão ao longo da qual ordenar.
direction
'ascend' ou 'descend'.

Argumentos de saída

B
Array ordenado, do mesmo tamanho de A.
I
Array de índices: B = A(I) para um vetor.

Exemplo

[s, i] = sort([3 1 2])
sort([3 1 2], 'descend')
sort([3 1; 2 5], 2)
sort({'pear', 'apple', 'fig'})
Saída
s = 1×3

     1     2     3
i = 1×3

     2     3     1
ans = 1×3

     3     2     1
ans = 2×2

     1     3
     2     5
ans = 1×3 cell

    {'apple'}    {'fig'}    {'pear'}

Veja também

sortrows issorted max unique cummax