cpp/algorithm/max element — различия между версиями

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

Версия 01:32, 3 июня 2015

Определено в заголовочном файле `<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) `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 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

См. также

min_element	возвращает наименьший элемент в диапазоне (шаблон функции) [править]
minmax_element (C++11)	возвращает наименьший и наибольший элементы в диапазоне (шаблон функции) [править]
max	возвращает большее из заданных значений (шаблон функции) [править]

Источник — «https://ru.cppreference.com/mwiki/index.php?title=cpp/algorithm/max_element&oldid=41496»

@@ Строка 1: / Строка 1: @@
-{{tr_note}}
 {{cpp/title|max_element}}
 {{cpp/algorithm/navbar}}
@@ Строка 14: / Строка 13: @@
 {{dcl end}}
-Finds the greatest element in the range {{tt|[first, last)}}. The first version uses {{c|operator<}} to compare the values, the second version uses the given comparison function {{tt|comp}}.
+{{tt|[first, last)}}. {{c|operator<}} , {{tt|comp}}.
 ===Параметры===
 {{par begin}}
-{{par | first, last |{{tr| вперед итераторы определении диапазона для изучения| forward iterators defining the range to examine}}}}
+{{par | first, last | итераторы}}
-{{par cmp | cmp | p1=ForwardIt | if {{tt|*a}} is ''less'' than {{tt|*b}}}}
+{{par cmp | cmp | p1=ForwardIt | {{tt|*a}} '''' {{tt|*b}}}}
 {{par hreq}}
 {{par req concept | ForwardIt | ForwardIterator}}
@@ Строка 25: / Строка 24: @@
 ===Возвращаемое значение===
-Iterator to the greatest element in the range {{tt|[first, last)}}. If several elements in the range are equivalent to the greatest element, returns the iterator to the first such element. Returns {{tt|last}} if the range is empty.
+[first, last). , . last.
 ===Сложность===
-{{tr|Именно {{math|max(N-1,0)}} сравнений, где {{c|N {{=}} std::distance(first, last)}}.|Exactly {{math|max(N-1,0)}} comparisons, where {{c|N {{=}} std::distance(first, last)}}.}}
+{{math|max(N-1,0)}} сравнений, где {{c|N {{=}} std::distance(first, last)}}.
 ===Возможная реализация===

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

cppreference.com

Пространства имён

Варианты

Просмотры

Действия