| Iterator concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator primitives | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Algorithm concepts and utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Indirect callable concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Common algorithm requirements | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator adaptors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
| Non-member functions | ||||
(C++20)(C++20) | ||||
operator+ (C++20) | ||||
(C++20) | ||||
(C++20) | ||||
(C++20) | ||||
| Helper classes | ||||
friendconstexpr counted_iterator operator+( std::iter_difference_t<I> n,const counted_iterator& x) | (since C++20) | |
Returns an iterator adaptor which is advanced byn. The behavior is undefined ifn is greater than the length recorded withinx (i.e. ifx+ n result in undefined behavior).
This function is not visible to ordinaryunqualified orqualified lookup, and can only be found byargument-dependent lookup when std::counted_iterator<I> is an associated class of the arguments.
Contents |
| n | - | the number of positions to increment the iterator |
| x | - | the iterator adaptor to increment |
An iterator adaptor equal tox+ n.
#include <iostream>#include <iterator>#include <list>#include <vector> int main(){std::vector v{0,1,2,3,4,5};std::counted_iterator<std::vector<int>::iterator> p{v.begin()+1,4};std::cout<<"*p:"<<*p<<", count:"<< p.count()<<'\n';std::counted_iterator<std::vector<int>::iterator> q{2+ p};std::cout<<"*q:"<<*q<<", count:"<< q.count()<<'\n'; std::list l{6,7,8,9};std::counted_iterator<std::list<int>::iterator> r{l.begin(),3};std::cout<<"*r:"<<*r<<", count:"<< r.count()<<'\n';// auto s{2 + r}; // error: the underlying iterator does// not model std::random_access_iterator}
Output:
*p:1, count:4*q:3, count:2*r:6, count:3
advances or decrements thecounted_iterator(public member function)[edit] | |
(C++20) | computes the distance between two iterator adaptors (function template)[edit] |
| computes the signed distance to the end (function template)[edit] |
