stl_iterator.h File Reference

This graph shows which files directly or indirectly include this file:

Included by dependency graph

Go to the source code of this file.

Namespaces

namespace  std
namespace  __gnu_cxx

Classes

class  std::reverse_iterator< Iterator >
class  std::back_insert_iterator< Container >
 Turns assignment into insertion. More...
class  std::front_insert_iterator< Container >
 Turns assignment into insertion. More...
class  std::insert_iterator< Container >
 Turns assignment into insertion. More...

Functions

template<typename Container> back_insert_iterator< Container > back_inserter (Container &x)
template<typename Container> front_insert_iterator< Container > front_inserter (Container &x)
template<typename Container, typename Iterator> insert_iterator< Container > inserter (Container &x, Iterator __i)


Detailed Description

This is an internal header file, included by other library headers. You should not attempt to use it directly.

This file implements reverse_iterator, back_insert_iterator, front_insert_iterator, insert_iterator, normal_iterator, and their supporting functions and overloaded operators.

Definition in file stl_iterator.h.


Function Documentation

template<typename Container>
back_insert_iterator<Container> back_inserter Container &  x  )  [inline]
 

Parameters:
x A container of arbitrary type.
Returns:
An instance of back_insert_iterator working on x.
This wrapper function helps in creating back_insert_iterator instances. Typing the name of the iterator requires knowing the precise full type of the container, which can be tedious and impedes generic programming. Using this function lets you take advantage of automatic template parameter deduction, making the compiler match the correct types for you. Definition at line 402 of file stl_iterator.h.

template<typename Container>
front_insert_iterator<Container> front_inserter Container &  x  )  [inline]
 

Parameters:
x A container of arbitrary type.
Returns:
An instance of front_insert_iterator working on x.
This wrapper function helps in creating front_insert_iterator instances. Typing the name of the iterator requires knowing the precise full type of the container, which can be tedious and impedes generic programming. Using this function lets you take advantage of automatic template parameter deduction, making the compiler match the correct types for you. Definition at line 473 of file stl_iterator.h.

template<typename Container, typename Iterator>
insert_iterator<Container> inserter Container &  x,
Iterator  __i
[inline]
 

Parameters:
x A container of arbitrary type.
Returns:
An instance of insert_iterator working on x.
This wrapper function helps in creating insert_iterator instances. Typing the name of the iterator requires knowing the precise full type of the container, which can be tedious and impedes generic programming. Using this function lets you take advantage of automatic template parameter deduction, making the compiler match the correct types for you. Definition at line 566 of file stl_iterator.h.

template<typename Iterator>
bool operator!= const reverse_iterator< Iterator > &  x,
const reverse_iterator< Iterator > &  y
[inline]
 

Parameters:
x A reverse_iterator.
y A reverse_iterator.
Returns:
A simple bool.
Reverse iterators forward many operations to their underlying base() iterators. Others are implemented in terms of one another. Definition at line 297 of file stl_iterator.h.

template<typename Iterator>
reverse_iterator<Iterator> operator+ typename reverse_iterator< Iterator >::difference_type  n,
const reverse_iterator< Iterator > &  x
[inline]
 

Parameters:
x A reverse_iterator.
y A reverse_iterator.
Returns:
A simple bool.
Reverse iterators forward many operations to their underlying base() iterators. Others are implemented in terms of one another. Definition at line 327 of file stl_iterator.h.

template<typename Iterator>
reverse_iterator<Iterator>::difference_type operator- const reverse_iterator< Iterator > &  x,
const reverse_iterator< Iterator > &  y
[inline]
 

Parameters:
x A reverse_iterator.
y A reverse_iterator.
Returns:
A simple bool.
Reverse iterators forward many operations to their underlying base() iterators. Others are implemented in terms of one another. Definition at line 321 of file stl_iterator.h.

template<typename Iterator>
bool operator< const reverse_iterator< Iterator > &  x,
const reverse_iterator< Iterator > &  y
[inline]
 

Parameters:
x A reverse_iterator.
y A reverse_iterator.
Returns:
A simple bool.
Reverse iterators forward many operations to their underlying base() iterators. Others are implemented in terms of one another. Definition at line 291 of file stl_iterator.h.

template<typename Iterator>
bool operator<= const reverse_iterator< Iterator > &  x,
const reverse_iterator< Iterator > &  y
[inline]
 

Parameters:
x A reverse_iterator.
y A reverse_iterator.
Returns:
A simple bool.
Reverse iterators forward many operations to their underlying base() iterators. Others are implemented in terms of one another. Definition at line 309 of file stl_iterator.h.

References std::reverse_iterator< Iterator >::base().

template<typename Iterator>
bool operator== const reverse_iterator< Iterator > &  x,
const reverse_iterator< Iterator > &  y
[inline]
 

Parameters:
x A reverse_iterator.
y A reverse_iterator.
Returns:
A simple bool.
Reverse iterators forward many operations to their underlying base() iterators. Others are implemented in terms of one another. Definition at line 285 of file stl_iterator.h.

template<typename Iterator>
bool operator> const reverse_iterator< Iterator > &  x,
const reverse_iterator< Iterator > &  y
[inline]
 

Parameters:
x A reverse_iterator.
y A reverse_iterator.
Returns:
A simple bool.
Reverse iterators forward many operations to their underlying base() iterators. Others are implemented in terms of one another. Definition at line 303 of file stl_iterator.h.

template<typename Iterator>
bool operator>= const reverse_iterator< Iterator > &  x,
const reverse_iterator< Iterator > &  y
[inline]
 

Parameters:
x A reverse_iterator.
y A reverse_iterator.
Returns:
A simple bool.
Reverse iterators forward many operations to their underlying base() iterators. Others are implemented in terms of one another. Definition at line 315 of file stl_iterator.h.

References std::reverse_iterator< Iterator >::base().


Generated on Wed Aug 4 21:43:54 2004 for libstdc++-v3 Source by doxygen 1.3.8