Returns the elements of the sequence, sorted.

SDK

- Xcode 8.0+

Framework

- Swift Standard Library

## Declaration

## Return Value

A sorted array of the sequence’s elements.

## Discussion

You can sort any sequence of elements that conform to the `Comparable`

protocol by calling this method. Elements are sorted in ascending order.

Here’s an example of sorting a list of students’ names. Strings in Swift conform to the `Comparable`

protocol, so the names are sorted in ascending order according to the less-than operator (`<`

).

To sort the elements of your sequence in descending order, pass the greater-than operator (`>`

) to the `sorted(by:)`

method.

The sorting algorithm is not guaranteed to be stable. A stable sort preserves the relative order of elements that compare equal.

Complexity: O(*n* log *n*), where *n* is the length of the sequence.