You are using a version without Ads of this website. Please, consider donating:
function template
<algorithm>

# std::sort

default (1) ```template void sort (RandomAccessIterator first, RandomAccessIterator last); ``` ```template void sort (RandomAccessIterator first, RandomAccessIterator last, Compare comp);```
Sort elements in range
Sorts the elements in the range `[first,last)` into ascending order.

The elements are compared using `operator<` for the first version, and comp for the second.

Equivalent elements are not guaranteed to keep their original relative order (see stable_sort).

### Parameters

first, last
Random-access iterators to the initial and final positions of the sequence to be sorted. The range used is `[first,last)`, which contains all the elements between first and last, including the element pointed by first but not the element pointed by last.
RandomAccessIterator shall point to a type for which swap is properly defined and which is both move-constructible and move-assignable.
comp
Binary function that accepts two elements in the range as arguments, and returns a value convertible to `bool`. The value returned indicates whether the element passed as first argument is considered to go before the second in the specific strict weak ordering it defines.
The function shall not modify any of its arguments.
This can either be a function pointer or a function object.

none

### Example

 ``1234567891011121314151617181920212223242526272829303132`` ``````// sort algorithm example #include // std::cout #include // std::sort #include // std::vector bool myfunction (int i,int j) { return (i myvector (myints, myints+8); // 32 71 12 45 26 80 53 33 // using default comparison (operator <): std::sort (myvector.begin(), myvector.begin()+4); //(12 32 45 71)26 80 53 33 // using function as comp std::sort (myvector.begin()+4, myvector.end(), myfunction); // 12 32 45 71(26 33 53 80) // using object as comp std::sort (myvector.begin(), myvector.end(), myobject); //(12 26 32 33 45 53 71 80) // print out content: std::cout << "myvector contains:"; for (std::vector::iterator it=myvector.begin(); it!=myvector.end(); ++it) std::cout << ' ' << *it; std::cout << '\n'; return 0; }``````

Output:
 ```myvector contains: 12 26 32 33 45 53 71 80 ```

### Complexity

On average, linearithmic in the distance between first and last: Performs approximately `N*log2(N)` (where N is this distance) comparisons of elements, and up to that many element swaps (or moves).

### Data races

The objects in the range `[first,last)` are modified.

### Exceptions

Throws if any of the element comparisons, the element swaps (or moves) or the operations on iterators throws.
Note that invalid arguments cause undefined behavior.