| Prev Next | Back Along | Up Home | Full TOC | Front Page / Iterators / Iterator Metafunctions / next |

next

Synopsis

template<
      typename Iterator
    >
struct[next](./next.html){
    typedef_unspecified_type;
};

Description

Returns the next iterator in the sequence. [Note: next has a number of overloaded meanings, depending on the type of its argument. For instance, if X is an Integral Constant, next<X> returns an incremented Integral Constant of the same type. The following specification is iterator-specific. Please refer to the corresponding concept's documentation for the details of the alternative semantics — end note].

Header

#include <[boost/mpl/next\_prior.hpp](../../../../boost/mpl/next_prior.hpp)>

Parameters

Expression semantics

For any Forward Iterators iter:

typedef[next](./next.html)<iter>::type j;

| Return type: |

Forward Iterator.

| | Precondition: |

iter is incrementable.

| | Semantics: |

j is an iterator pointing to the next element in the sequence, or is past-the-end. If iter is a user-defined iterator, the library-provided default implementation is equivalent to

typedef iter::[next](./next.html)j;

|

Complexity

Amortized constant time.

Example

typedef[vector\_c](./vector-c.html)<int,1> v;
typedef[begin](./begin.html)<v>::type first;
typedef[end](./end.html)<v>::type last;[BOOST\_MPL\_ASSERT](./assert.html)(( is_same<[next](./next.html)<first>::type, last > ));

See also

Iterators, begin / end, prior, deref

| Prev Next | Back Along | Up Home | Full TOC |

Copyright © 2001-2009 Aleksey Gurtovoy and David Abrahams Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) |