advance

Moves an iterator by a specified distance.

template<
    typename I,
    typename M
    >
typename result_of::advance<I, M>::type advance(I const& i);

Table 1.6. Parameters

Parameter	Requirement	Description
`i`	Model of Forward Iterator	Iterator to move relative to
`N`	An MPL Integral Constant	Number of positions to move

advance<M>(i);

Return type: A model of the same iterator concept as i.

Semantics: Returns an iterator to the element M positions from i. If i is a Bidirectional Iterator then M may be negative.

#include <boost/fusion/iterator/advance.hpp>

typedef vector<int,int,int> vec;

vec v(1,2,3);
assert(deref(advance<mpl::int_<2> >(begin(v))) == 3);