std::minmax_element

Определено в заголовке `<algorithm>`
template< class ForwardIt > std::pair<ForwardIt, ForwardIt> minmax_element( ForwardIt first, ForwardIt last );	(1)	(начиная с C++11) (constexpr начиная с C++17)
template< class ExecutionPolicy, class ForwardIt > std::pair<ForwardIt, ForwardIt> minmax_element( ExecutionPolicy&& policy, ForwardIt first, ForwardIt last );	(2)	(начиная с C++17)
template< class ForwardIt, class Compare > std::pair<ForwardIt, ForwardIt> minmax_element( ForwardIt first, ForwardIt last, Compare comp );	(3)	(начиная с C++11) (constexpr начиная с C++17)
template< class ExecutionPolicy, class ForwardIt, class Compare > std::pair<ForwardIt, ForwardIt> minmax_element( ExecutionPolicy&& policy, ForwardIt first, ForwardIt last, Compare comp );	(4)	(начиная с C++17)

Находит наименьший и наибольший элементы в диапазоне [first, last).

1) Элементы сравниваются с помощью operator<(до C++20)std::less{}(начиная с C++20).

3) Элементы сравниваются с помощью функции сравнения comp.

2,4) То же, что и (1,3), но выполняется в соответствии с policy.

Эти перегрузки участвуют в разрешении перегрузки только если значение следующего выражения равно true:

`std::is_execution_policy_v<std::decay_t<ExecutionPolicy>>`	(до C++20)
`std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>>`	(начиная с C++20)

Параметры

first, last	-	пара итераторов, определяющая диапазон элементов для проверки
policy	-	политика выполнения для использования
cmp	-	объект функции сравнения (т.е. объект, удовлетворяющий требованиям Compare), который возвращает `true` если первый аргумент меньше второго. Сигнатура функции сравнения должна быть эквивалентна следующей: `bool cmp(const Type1& a, const Type2& b);` Хотя сигнатура не обязательно должна содержать `const&`, функция не должна изменять переданные ей объекты и должна поддерживать все значения типа (возможно, const) `Type1` и `Type2` независимо от категории значения (таким образом, `Type1&` не допускается, как и `Type1` за исключением случаев, когда для `Type1` перемещение эквивалентно копированию(начиная с C++11)). Типы `Type1` и `Type2` должны быть такими, что объект типа `ForwardIt` можно разыменовать и затем неявно преобразовать к обоим из них.
Требования к типам
- `ForwardIt` должен удовлетворять требованиям LegacyForwardIterator.

Возвращаемое значение

пара, состоящая из итератора на наименьший элемент в качестве первого элемента и итератора на наибольший элемент в качестве второго. Возвращает std::make_pair(first, first) если диапазон пуст. Если несколько элементов эквивалентны наименьшему элементу, возвращается итератор на первый такой элемент. Если несколько элементов эквивалентны наибольшему элементу, возвращается итератор на последний такой элемент.

Сложность

Пусть $\scriptsize N$ $N$ равно std::distance(first, last):

1,2) Не более

max(⌊ 32 (N-1)⌋,0)

сравнений с использованием operator<(до C++20)std::less{}(начиная с C++20).

3,4) Не более

max(⌊ 32 (N-1)⌋,0)

применений функции сравнения comp.

Исключения

Перегрузки с параметром шаблона с именем ExecutionPolicy сообщают об ошибках следующим образом:

Если выполнение функции, вызванной в рамках алгоритма, генерирует исключение и ExecutionPolicy является одной из стандартных политик, вызывается std::terminate. Для любого другого ExecutionPolicy поведение определяется реализацией.
Если алгоритму не удаётся выделить память, генерируется std::bad_alloc.

Возможная реализация

minmax_element

template<class ForwardIt>
std::pair<ForwardIt, ForwardIt>
    minmax_element(ForwardIt first, ForwardIt last)
{
    using value_type = typename std::iterator_traits<ForwardIt>::value_type;
    return std::minmax_element(first, last, std::less<value_type>());
}

minmax_element

template<class ForwardIt, class Compare>
std::pair<ForwardIt, ForwardIt>
    minmax_element(ForwardIt first, ForwardIt last, Compare comp)
{
    auto min = first, max = first;
    
    if (first == last || ++first == last)
        return {min, max};
    
    if (comp(*first, *min))
        min = first;
    else
        max = first;
    
    while (++first != last)
    {
        auto i = first;
        if (++first == last)
        {
            if (comp(*i, *min))
                min = i;
            else if (!(comp(*i, *max)))
                max = i;
            break;
        }
        else
        {
            if (comp(*first, *i))
            {
                if (comp(*first, *min))
                    min = first;
                if (!(comp(*i, *max)))
                    max = i;
            }
            else
            {
                if (comp(*i, *min))
                    min = i;
                if (!(comp(*first, *max)))
                    max = first;
            }
        }
    }
    return {min, max};
}

Примечания

Этот алгоритм отличается от std::make_pair(std::min_element(), std::max_element()) не только эффективностью, но также тем, что этот алгоритм находит последний наибольший элемент, в то время как std::max_element находит первый наибольший элемент.

Пример

Запустить этот код

#include <algorithm>
#include <iostream>
 
int main()
{
    const auto v = {3, 9, 1, 4, 2, 5, 9};
    const auto [min, max] = std::minmax_element(begin(v), end(v));

    std::cout << "min = " << *min << ", max = " << *max << '\n';
}

Вывод:

min = 1, max = 9

См. также

min_element	возвращает наименьший элемент в диапазоне (шаблон функции & объект функции алгоритма)
ranges::min_element (C++20)
max_element	возвращает наибольший элемент в диапазоне (шаблон функции & объект функции алгоритма)
ranges::max_element (C++20)
ranges::minmax_element (C++20)	возвращает наименьший и наибольший элементы в диапазоне (объект функции алгоритма)

Поддержка компиляторов
Автономное и размещённое
Язык
Стандартная библиотека
Заголовки стандартной библиотеки
Именованные требования
Макросы проверки возможностей (C++20)
Библиотека поддержки языка
Библиотека концептов (C++20)
Библиотека диагностики
Библиотека управления памятью
Библиотека метапрограммирования (C++11)
Библиотека общих утилит
Библиотека контейнеров
Библиотека итераторов
Библиотека диапазонов (C++20)
Библиотека алгоритмов
Библиотека строк
Библиотека обработки текста
Библиотека численных операций
Библиотека даты и времени
Библиотека ввода/вывода
Библиотека файловой системы (C++17)
Библиотека поддержки параллелизма (C++11)
Библиотека управления выполнением (C++26)
Технические спецификации
Индекс символов
Внешние библиотеки

ru.cppreference.net

Namespaces

Variants