epoc32/include/stdapis/boost/multi_array/iterator.hpp
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h)
This is the epoc32/include tree with the "platform" subtrees removed, and
all but a selected few mbg and rsg files removed.
williamr@4
     1
// Copyright 2002 The Trustees of Indiana University.
williamr@4
     2
williamr@4
     3
// Use, modification and distribution is subject to the Boost Software 
williamr@4
     4
// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
williamr@4
     5
// http://www.boost.org/LICENSE_1_0.txt)
williamr@4
     6
williamr@4
     7
//  Boost.MultiArray Library
williamr@4
     8
//  Authors: Ronald Garcia
williamr@4
     9
//           Jeremy Siek
williamr@4
    10
//           Andrew Lumsdaine
williamr@4
    11
//  See http://www.boost.org/libs/multi_array for documentation.
williamr@4
    12
williamr@4
    13
#ifndef ITERATOR_RG071801_HPP
williamr@4
    14
#define ITERATOR_RG071801_HPP
williamr@4
    15
williamr@4
    16
//
williamr@4
    17
// iterator.hpp - implementation of iterators for the
williamr@4
    18
// multi-dimensional array class
williamr@4
    19
//
williamr@4
    20
williamr@4
    21
#include "boost/multi_array/base.hpp"
williamr@4
    22
#include "boost/iterator/iterator_facade.hpp"
williamr@4
    23
#include "boost/mpl/aux_/msvc_eti_base.hpp"
williamr@4
    24
#include <algorithm>
williamr@4
    25
#include <cstddef>
williamr@4
    26
#include <iterator>
williamr@4
    27
williamr@4
    28
namespace boost {
williamr@4
    29
namespace detail {
williamr@4
    30
namespace multi_array {
williamr@4
    31
williamr@4
    32
/////////////////////////////////////////////////////////////////////////
williamr@4
    33
// iterator components
williamr@4
    34
/////////////////////////////////////////////////////////////////////////
williamr@4
    35
williamr@4
    36
template <class T>
williamr@4
    37
struct operator_arrow_proxy
williamr@4
    38
{
williamr@4
    39
  operator_arrow_proxy(T const& px) : value_(px) {}
williamr@4
    40
  T* operator->() const { return &value_; }
williamr@4
    41
  // This function is needed for MWCW and BCC, which won't call operator->
williamr@4
    42
  // again automatically per 13.3.1.2 para 8
williamr@4
    43
  operator T*() const { return &value_; }
williamr@4
    44
  mutable T value_;
williamr@4
    45
};
williamr@4
    46
williamr@4
    47
template <typename T, typename TPtr, typename NumDims, typename Reference>
williamr@4
    48
class array_iterator;
williamr@4
    49
williamr@4
    50
template <typename T, typename TPtr, typename NumDims, typename Reference>
williamr@4
    51
class array_iterator
williamr@4
    52
  : public
williamr@4
    53
    iterator_facade<
williamr@4
    54
        array_iterator<T,TPtr,NumDims,Reference>
williamr@4
    55
      , typename associated_types<T,NumDims>::value_type
williamr@4
    56
      , boost::random_access_traversal_tag
williamr@4
    57
      , Reference
williamr@4
    58
    >
williamr@4
    59
    , private
williamr@4
    60
#if BOOST_WORKAROUND(BOOST_MSVC, < 1300)
williamr@4
    61
      mpl::aux::msvc_eti_base<typename 
williamr@4
    62
#endif 
williamr@4
    63
          value_accessor_generator<T,NumDims>::type
williamr@4
    64
#if BOOST_WORKAROUND(BOOST_MSVC, < 1300)
williamr@4
    65
      >::type
williamr@4
    66
#endif 
williamr@4
    67
{
williamr@4
    68
  friend class iterator_core_access;
williamr@4
    69
  typedef detail::multi_array::associated_types<T,NumDims> access_t;
williamr@4
    70
williamr@4
    71
  typedef iterator_facade<
williamr@4
    72
        array_iterator<T,TPtr,NumDims,Reference>
williamr@4
    73
      , typename detail::multi_array::associated_types<T,NumDims>::value_type
williamr@4
    74
      , boost::random_access_traversal_tag
williamr@4
    75
      , Reference
williamr@4
    76
    > facade_type;
williamr@4
    77
williamr@4
    78
  typedef typename access_t::index index;
williamr@4
    79
  typedef typename access_t::size_type size_type;
williamr@4
    80
williamr@4
    81
#ifndef BOOST_NO_MEMBER_TEMPLATE_FRIENDS
williamr@4
    82
  template <typename, typename, typename, typename>
williamr@4
    83
    friend class array_iterator;
williamr@4
    84
#else
williamr@4
    85
 public:
williamr@4
    86
#endif 
williamr@4
    87
williamr@4
    88
  index idx_;
williamr@4
    89
  TPtr base_;
williamr@4
    90
  const size_type* extents_;
williamr@4
    91
  const index* strides_;
williamr@4
    92
  const index* index_base_;
williamr@4
    93
 
williamr@4
    94
public:
williamr@4
    95
  // Typedefs to circumvent ambiguities between parent classes
williamr@4
    96
  typedef typename facade_type::reference reference;
williamr@4
    97
  typedef typename facade_type::value_type value_type;
williamr@4
    98
  typedef typename facade_type::difference_type difference_type;
williamr@4
    99
williamr@4
   100
  array_iterator() {}
williamr@4
   101
williamr@4
   102
  array_iterator(index idx, TPtr base, const size_type* extents,
williamr@4
   103
                const index* strides,
williamr@4
   104
                const index* index_base) :
williamr@4
   105
    idx_(idx), base_(base), extents_(extents),
williamr@4
   106
    strides_(strides), index_base_(index_base) { }
williamr@4
   107
williamr@4
   108
  template <typename OPtr, typename ORef>
williamr@4
   109
  array_iterator(
williamr@4
   110
      const array_iterator<T,OPtr,NumDims,ORef>& rhs
williamr@4
   111
    , typename boost::enable_if_convertible<OPtr,TPtr>::type* = 0
williamr@4
   112
  )
williamr@4
   113
    : idx_(rhs.idx_), base_(rhs.base_), extents_(rhs.extents_),
williamr@4
   114
    strides_(rhs.strides_), index_base_(rhs.index_base_) { }
williamr@4
   115
williamr@4
   116
williamr@4
   117
  // RG - we make our own operator->
williamr@4
   118
  operator_arrow_proxy<reference>
williamr@4
   119
  operator->() const
williamr@4
   120
  {
williamr@4
   121
    return operator_arrow_proxy<reference>(this->dereference());
williamr@4
   122
  }
williamr@4
   123
  
williamr@4
   124
williamr@4
   125
  reference dereference() const
williamr@4
   126
  {
williamr@4
   127
    typedef typename value_accessor_generator<T,NumDims>::type accessor;
williamr@4
   128
    return accessor::access(boost::type<reference>(),
williamr@4
   129
                            idx_,
williamr@4
   130
                            base_,
williamr@4
   131
                            extents_,
williamr@4
   132
                            strides_,
williamr@4
   133
                            index_base_);
williamr@4
   134
  }
williamr@4
   135
  
williamr@4
   136
  void increment() { ++idx_; }
williamr@4
   137
  void decrement() { --idx_; }
williamr@4
   138
williamr@4
   139
  template <class IteratorAdaptor>
williamr@4
   140
  bool equal(IteratorAdaptor& rhs) const {
williamr@4
   141
    const std::size_t N = NumDims::value;
williamr@4
   142
    return (idx_ == rhs.idx_) &&
williamr@4
   143
      (base_ == rhs.base_) &&
williamr@4
   144
      ( (extents_ == rhs.extents_) ||
williamr@4
   145
        std::equal(extents_,extents_+N,rhs.extents_) ) &&
williamr@4
   146
      ( (strides_ == rhs.strides_) ||
williamr@4
   147
        std::equal(strides_,strides_+N,rhs.strides_) ) &&
williamr@4
   148
      ( (index_base_ == rhs.index_base_) ||
williamr@4
   149
        std::equal(index_base_,index_base_+N,rhs.index_base_) );
williamr@4
   150
  }
williamr@4
   151
williamr@4
   152
  template <class DifferenceType>
williamr@4
   153
  void advance(DifferenceType n) {
williamr@4
   154
    idx_ += n;
williamr@4
   155
  }
williamr@4
   156
williamr@4
   157
  template <class IteratorAdaptor>
williamr@4
   158
  typename facade_type::difference_type
williamr@4
   159
  distance_to(IteratorAdaptor& rhs) const {
williamr@4
   160
    return rhs.idx_ - idx_;
williamr@4
   161
  }
williamr@4
   162
williamr@4
   163
williamr@4
   164
};
williamr@4
   165
williamr@4
   166
} // namespace multi_array
williamr@4
   167
} // namespace detail
williamr@4
   168
} // namespace boost
williamr@4
   169
williamr@4
   170
#endif // ITERATOR_RG071801_HPP