Standard C++ LibraryCopyright 1996, Rogue Wave Software, Inc.

NAME

  raw_storage_iterator  - Enables iterator-based algorithms to store results
  into uninitialized memory.

SYNOPSIS

  #include <memory>

  template <class OutputIterator, class T>
  class raw_storage_iterator : public output_iterator {

  public:
    explicit raw_storage_iterator (OutputIterator);
    raw_storage_iterator<OutputIterator, t>& operator*();
    raw_storage_iterator<OutputIterator, T>&
      operator= (const T&);
    raw_storage_iterator<OutputIterator>& operator++();
    raw_storage_iterator<OutputIterator> operator++ (int);
  };

DESCRIPTION

  Class raw_storage_iterator enables iterator-based algorithms to store their
  results in uninitialized memory.  The template parameter, OutputIterator is
  required to have its operator* return an object for which operator& is both
  defined and returns a pointer to T.

CONSTRUCTOR

  raw_storage_iterator (OutputIterator x);
     Initializes the iterator to point to the same value that x points to.

MEMBER OPERATORS

  raw_storage_iterator <OutputIterator, T>&
    operator =(const T& element);
       Constructs an instance of T, initialized to the value element , at the
       location pointed to by the iterator.

  raw_storage_iterator <OutputIterator, T>&
  operator++();
      Pre-increment:  advances the iterator and returns a reference to the
     updated iterator.

  raw_storage_iterator<OutputIterator>
   operator++ (int);

     Post-increment:  advances the iterator and returns the old value of the
     iterator.

STANDARDS CONFORMANCE

  ANSI X3J16/ISO WG21 Joint C++ Committee