| Constrained algorithms and algorithms on ranges(C++20) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Constrained algorithms, e.g.ranges::copy,ranges::sort, ... | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Execution policies(C++17) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Numeric operations | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Operations on uninitialized memory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
std::ranges| Non-modifying sequence operations | |||||||||||||||||||||||||||||||||
| Modifying sequence operations | |||||||||||||||||||||||||||||||||
| Partitioning operations | |||||||||||||||||||||||||||||||||
| Sorting operations | |||||||||||||||||||||||||||||||||
| Binary search operations (on sorted ranges) | |||||||||||||||||||||||||||||||||
| Set operations (on sorted ranges) | |||||||||||||||||||||||||||||||||
| Heap operations | |||||||||||||||||||||||||||||||||
| Minimum/maximum operations | |||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||
| Permutation operations | |||||||||||||||||||||||||||||||||
| Fold operations | |||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||
| Operations on uninitialized storage | |||||||||||||||||||||||||||||||||
| Return types | |||||||||||||||||||||||||||||||||
Defined in header <algorithm> | ||
Call signature | ||
template<std::forward_iterator I,std::sentinel_for<I> S,class Proj=std::identity, std::indirect_strict_weak_order<std::projected<I, Proj>> Comp=ranges::less> | (1) | (since C++20) |
template<ranges::forward_range R,class Proj=std::identity, std::indirect_strict_weak_order< | (2) | (since C++20) |
[first, last).The function-like entities described on this page arealgorithm function objects (informally known asniebloids), that is:
Contents |
| first, last | - | the iterator-sentinel pair defining therange of elements to examine |
| r | - | therange to examine |
| comp | - | comparison to apply to the projected elements |
| proj | - | projection to apply to the elements |
Iterator to the smallest element in the range[first, last). If several elements in the range are equivalent to the smallest element, returns the iterator to the first such element. Returns the iterator that compares equal tolast if the range is empty (i.e.,first== last).
Exactlymax(N - 1, 0) comparisons, whereN=ranges::distance(first, last).
struct min_element_fn{template<std::forward_iterator I,std::sentinel_for<I> S,class Proj=std::identity,std::indirect_strict_weak_order<std::projected<I, Proj>> Comp=ranges::less>constexpr I operator()(I first, S last, Comp comp={}, Proj proj={})const{if(first== last)return last;auto smallest= first;while(++first!= last)if(std::invoke(comp,std::invoke(proj,*first),std::invoke(proj,*smallest))) smallest= first;return smallest;} template<ranges::forward_range R,class Proj=std::identity,std::indirect_strict_weak_order< std::projected<ranges::iterator_t<R>, Proj>> Comp=ranges::less>constexprranges::borrowed_iterator_t<R> operator()(R&& r, Comp comp={}, Proj proj={})const{return(*this)(ranges::begin(r),ranges::end(r),std::ref(comp),std::ref(proj));}}; inlineconstexpr min_element_fn min_element; |
#include <algorithm>#include <array>#include <cmath>#include <iostream> int main(){namespace ranges= std::ranges; std::array v{3,1,-13,1,3,7,-13}; auto iterator= ranges::min_element(v.begin(), v.end());auto position=ranges::distance(v.begin(), iterator);std::cout<<"min element is v["<< position<<"] == "<<*iterator<<'\n'; auto abs_compare=[](int a,int b){return(std::abs(a)< std::abs(b));}; iterator= ranges::min_element(v, abs_compare); position=ranges::distance(v.begin(), iterator);std::cout<<"|min| element is v["<< position<<"] == "<<*iterator<<'\n';}
Output:
min element is v[2] == -13|min| element is v[1] == 1
(C++20) | returns the largest element in a range (algorithm function object)[edit] |
(C++20) | returns the smallest and the largest elements in a range (algorithm function object)[edit] |
(C++20) | returns the greater of the given values (algorithm function object)[edit] |
| returns the smallest element in a range (function template)[edit] |
