std::is_sorted
| Определено в заголовке <algorithm>
|
||
template< class ForwardIt >
bool is_sorted( ForwardIt first, ForwardIt last );
|
(1) | (начиная с C++11) (constexpr начиная с C++20) |
template< class ExecutionPolicy, class ForwardIt >
bool is_sorted( ExecutionPolicy&& policy,
ForwardIt first, ForwardIt last );
|
(2) | (начиная с C++17) |
template< class ForwardIt, class Compare >
bool is_sorted( ForwardIt first, ForwardIt last, Compare comp );
|
(3) | (начиная с C++11) (constexpr начиная с C++20) |
template< class ExecutionPolicy, class ForwardIt, class Compare >
bool is_sorted( ExecutionPolicy&& policy,
ForwardIt first, ForwardIt last, Compare comp );
|
(4) | (начиная с C++17) |
Проверяет, отсортированы ли элементы в диапазоне [first, last) в неубывающем порядке.
operator<(до C++20)std::less{}(начиная с C++20).comp.policy.true:
|
|
(до C++20) |
|
|
(начиная с C++20) |
Параметры
| first, last | - | пара итераторов, определяющих диапазон исследуемых элементов |
| policy | - | политика выполнения для использования |
| comp | - | объект функции сравнения (т.е. объект, удовлетворяющий требованиям Compare), который возвращает true если первый аргумент меньше чем (т.е. упорядочен перед) второго. Сигнатура функции сравнения должна быть эквивалентна следующей:
Хотя сигнатура не обязательно должна содержать |
| Требования к типам | ||
-ForwardIt должен соответствовать требованиям LegacyForwardIterator.
| ||
-Compare должен соответствовать требованиям Compare.
| ||
Возвращаемое значение
true если элементы в диапазоне отсортированы в неубывающем порядке, false в противном случае.
Сложность
Пусть N — это std::distance(first, last):
operator<(до C++20)std::less{}(начиная с C++20).comp.Исключения
Перегрузки с параметром шаблона с именем ExecutionPolicy сообщают об ошибках следующим образом:
- Если выполнение функции, вызванной в рамках алгоритма, выбрасывает исключение и
ExecutionPolicyявляется одной из стандартных политик, вызывается std::terminate. Для любой другойExecutionPolicyповедение определяется реализацией. - Если алгоритму не удаётся выделить память, выбрасывается std::bad_alloc.
Возможная реализация
Смотрите также реализации в libstdc++ и libc++.
| is_sorted (1) |
|---|
template<class ForwardIt>
bool is_sorted(ForwardIt first, ForwardIt last)
{
return std::is_sorted_until(first, last) == last;
}
|
| is_sorted (3) |
template<class ForwardIt, class Compare>
bool is_sorted(ForwardIt first, ForwardIt last, Compare comp)
{
return std::is_sorted_until(first, last, comp) == last;
}
|
Примечания
std::is_sorted is_sorted возвращает true для пустых диапазонов и диапазонов длины один.
Пример
#include <algorithm>
#include <cassert>
#include <functional>
#include <iterator>
#include <vector>
int main()
{
std::vector<int> v;
assert(std::is_sorted(v.cbegin(), v.cend()) && "an empty range is always sorted");
v.push_back(42);
assert(std::is_sorted(v.cbegin(), v.cend()) && "a range of size 1 is always sorted");
int data[] = {3, 1, 4, 1, 5};
assert(not std::is_sorted(std::begin(data), std::end(data)));
std::sort(std::begin(data), std::end(data));
assert(std::is_sorted(std::begin(data), std::end(data)));
assert(not std::is_sorted(std::begin(data), std::end(data), std::greater<>{}));
}
Смотрите также
(C++11) |
находит наибольшую отсортированную подпоследовательность (шаблон функции & объект-функция алгоритма) |
(C++20) |
|
(C++20) |
проверяет, отсортирован ли диапазон (объект-функция алгоритма) |