std::max_element
| Определено в заголовочном файле <algorithm>
|
||
| template< class ForwardIt > ForwardIt max_element( ForwardIt first, ForwardIt last ); |
(1) | |
| template< class ForwardIt, class Compare > ForwardIt max_element( ForwardIt first, ForwardIt last, Compare comp ); |
(2) | |
Находит наибольший элемент в диапазоне [first, last). Первая версия использует operator< для сравнения значений, вторая — переданную функцию сравнения comp.
Содержание |
Параметры
| first, last | — | однонаправленные итераторы, задающие диапазон |
| cmp | — | объект функции сравнения (т.е. объект, удовлетворяющий требованиям Compare), который возвращает true, если *a меньше *b.Определение сравнения должно быть эквивалентно: bool cmp(const Type1 &a, const Type2 &b); Использование noexcept (начиная с C++11) желательно но не обязательно. Параметры не обязаны передаваться по const&, но не должны модифицироваться. Они должны быть способны принимать все значения типа (даже const) |
| Требования к типам | ||
-ForwardIt должен соответствовать требованиям ForwardIterator.
| ||
Возвращаемое значение
Итератор, указавающий на наибольший элемент в диапазоне [first, last). Если несколько элементов в диапазоне эквивалентны наибольшему, то возвращается итератор на первый такой элемент. Возвращает last, если диапазон пуст.
Сложность
В точности max(N-1,0) сравнений, где N = std::distance(first, last).
Возможная реализация
| Первый вариант |
|---|
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 comp) { if (first == last) { return last; } ForwardIt largest = first; ++first; for (; first != last; ++first) { if (comp(*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 << "max element at: " << std::distance(v.begin(), result) << '\n'; result = std::max_element(v.begin(), v.end(), abs_compare); std::cout << "max element (absolute) at: " << std::distance(v.begin(), result); }
Вывод:
max element at: 5 max element (absolute) at: 2
См. также
| возвращает наименьший элемент в диапазоне (шаблон функции) | |
| (C++11) |
возвращает наименьший и наибольший элементы в диапазоне (шаблон функции) |
| возвращает большее из заданных значений (шаблон функции) |