◐ Shell
clean mode source ↗

std::min_element — cppreference.com

Материал из cppreference.com

<tbody> </tbody>

Определено в заголовочном файле <algorithm>

template< class ForwardIt > ForwardIt min_element( ForwardIt first, ForwardIt last );

 (1)

template< class ForwardIt, class Compare > ForwardIt min_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) Type1 и Type2 независимо от категории значений (таким образом, Type1& не допускается, равно как и Type1, если только для Type1 перемещение не эквивалентно копированию (начиная с C++11)). Типы Type1 и Type2 должны быть таковы, что объект типа ForwardIt может быть разыменован и затем неявно преобразован в оба из них.

Требования к типам
-ForwardIt должен соответствовать требованиям ForwardIterator.

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

Итератор, указавающий на наименьший элемент в диапазоне [first, last). Если несколько элементов в диапазоне эквивалентны наименьшему, то возвращается итератор на первый такой элемент. Возвращает last, если диапазон пуст.

Сложность

В точности max(N-1,0) сравнений, где N = std::distance(first, last).

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

Первый вариант 
template<class ForwardIt>
ForwardIt min_element(ForwardIt first, ForwardIt last)
{
    if (first == last) return last;

    ForwardIt smallest = first;
    ++first;
    for (; first != last; ++first) {
        if (*first < *smallest) {
            smallest = first;
        }
    }
    return smallest;
}
Второй вариант 
template<class ForwardIt, class Compare>
ForwardIt min_element(ForwardIt first, ForwardIt last,
                            Compare comp)
{
    if (first == last) return last;

    ForwardIt smallest = first;
    ++first;
    for (; first != last; ++first) {
        if (comp(*first, *smallest)) {
            smallest = first;
        }
    }
    return smallest;
}

Пример

#include <algorithm>
#include <iostream>
#include <vector>

int main()
{
    std::vector<int> v{3, 1, 4, 1, 5, 9};

    std::vector<int>::iterator result = std::min_element(v.begin(), v.end());
    std::cout << "min element at: " << std::distance(v.begin(), result);
}

Вывод:

См. также