std::max_element
| Определено в заголовочном файле <algorithm>
|
||
| (1) | ||
template< class ForwardIt > ForwardIt max_element(ForwardIt first, ForwardIt last); |
(до C++17) | |
template< class ForwardIt > constexpr ForwardIt max_element(ForwardIt first, ForwardIt last); |
(начиная с C++17) | |
template< class ExecutionPolicy, class ForwardIt > ForwardIt max_element(ExecutionPolicy&& policy, ForwardIt first, ForwardIt last); |
(2) | (начиная с C++17) |
| (3) | ||
template< class ForwardIt, class Compare > ForwardIt max_element(ForwardIt first, ForwardIt last, Compare cmp); |
(до C++17) | |
template< class ForwardIt, class Compare > constexpr ForwardIt max_element(ForwardIt first, ForwardIt last, Compare cmp); |
(начиная с C++17) | |
template< class ExecutionPolicy, class ForwardIt, class Compare > ForwardIt max_element(ExecutionPolicy&& policy, ForwardIt first, ForwardIt last, Compare cmp); |
(4) | (начиная с C++17) |
Находит наибольший элемент в диапазоне [first, last).
operator<.comp.policy. Эти перегрузки не участвуют в разрешении перегрузок кроме случая, когда std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> равен true.Параметры
| first, last | — | forward-итераторы, определяющие диапазон для обработки |
| policy | — | используемая политика выполнения. Подробнее смотрите политика выполнения. |
| cmp | — | объект функции сравнения (т.е. объект, удовлетворяющий требованиям Compare), который возвращает true, если первый аргумент "меньше", чем второй.Определение сравнения должно быть эквивалентно:
Использование |
| Требования к типам | ||
-ForwardIt должен соответствовать требованиям ForwardIterator.
| ||
Возвращаемое значение
Итератор, указывающий на наибольший элемент в диапазоне [first, last). Если несколько элементов в диапазоне эквивалентны наибольшему элементу, то возвращается итератор на первый такой элемент. Если диапазон пуст, то возвращается last.
Сложность
В точности max(N-1,0) сравнений, где N = std::distance(first, last).
Исключения
Перегрузки с параметром шаблона по имени ExecutionPolicy сообщают об ошибках следующим образом:
- Если выполнение функции, вызванной как часть алгоритма, вызывает исключение и
ExecutionPolicyявляется одной из стандартных политик, вызывается std::terminate. Для любой другойExecutionPolicyповедение определяется реализацией. - Если алгоритму не удаётся выделить память, генерируется std::bad_alloc.
Возможная реализация
| Первый вариант |
|---|
template<class ForwardIt>
ForwardIt max_element(ForwardIt first, ForwardIt last)
{
if (first == last) {
return last;
}
ForwardIt largest = first;
++first;
for (; first != last; ++first) {
if (*largest < *first) {
largest = first;
}
}
return largest;
}
|
| Второй вариант |
template<class ForwardIt, class Compare>
ForwardIt max_element(ForwardIt first, ForwardIt last,
Compare cmp)
{
if (first == last) {
return last;
}
ForwardIt largest = first;
++first;
for (; first != last; ++first) {
if (cmp(*largest, *first)) {
largest = first;
}
}
return largest;
}
|
Пример
#include <algorithm>
#include <iostream>
#include <vector>
#include <cmath>
static bool abs_compare(int a, int b)
{
return (std::abs(a) < std::abs(b));
}
int main()
{
std::vector<int> v{ 3, 1, -14, 1, 5, 9 };
std::vector<int>::iterator result;
result = std::max_element(v.begin(), v.end());
std::cout << "индекс максимального элемента: " << std::distance(v.begin(), result) << '\n';
result = std::max_element(v.begin(), v.end(), abs_compare);
std::cout << "индекс максимального (по модулю) элемента: " << std::distance(v.begin(), result);
}
Вывод:
индекс максимального элемента: 5
индекс максимального (по модулю) элемента: 2
См. также
| возвращает наименьший элемент в диапазоне (шаблон функции) | |
(C++11) |
возвращает наименьший и наибольший элементы в диапазоне (шаблон функции) |
| возвращает большее из заданных значений (шаблон функции) |