std::min_element
| Определено в заголовочном файле <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.Определение сравнения должно быть эквивалентно:
Использование |
| Требования к типам | ||
-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);
}
Вывод:
min element at: 1
См. также
| возвращает наибольший элемент в диапазоне (шаблон функции) | |
(C++11) |
возвращает наименьший и наибольший элементы в диапазоне (шаблон функции) |
| возвращает меньшее из заданных значений (шаблон функции) |