epoc32/include/stdapis/boost/multi_array/subarray.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@2
     1
// Copyright 2002 The Trustees of Indiana University.
williamr@2
     2
williamr@2
     3
// Use, modification and distribution is subject to the Boost Software 
williamr@2
     4
// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
williamr@2
     5
// http://www.boost.org/LICENSE_1_0.txt)
williamr@2
     6
williamr@2
     7
//  Boost.MultiArray Library
williamr@2
     8
//  Authors: Ronald Garcia
williamr@2
     9
//           Jeremy Siek
williamr@2
    10
//           Andrew Lumsdaine
williamr@2
    11
//  See http://www.boost.org/libs/multi_array for documentation.
williamr@2
    12
williamr@2
    13
#ifndef SUBARRAY_RG071801_HPP
williamr@2
    14
#define SUBARRAY_RG071801_HPP
williamr@2
    15
williamr@2
    16
//
williamr@2
    17
// subarray.hpp - used to implement standard operator[] on
williamr@2
    18
// multi_arrays
williamr@2
    19
//
williamr@2
    20
williamr@2
    21
#include "boost/multi_array/base.hpp"
williamr@2
    22
#include "boost/multi_array/concept_checks.hpp"
williamr@2
    23
#include "boost/limits.hpp"
williamr@2
    24
#include "boost/type.hpp"
williamr@2
    25
#include <algorithm>
williamr@2
    26
#include <cstddef>
williamr@2
    27
#include <functional>
williamr@2
    28
williamr@2
    29
namespace boost {
williamr@2
    30
namespace detail {
williamr@2
    31
namespace multi_array {
williamr@2
    32
williamr@2
    33
//
williamr@2
    34
// const_sub_array
williamr@2
    35
//    multi_array's proxy class to allow multiple overloads of
williamr@2
    36
//    operator[] in order to provide a clean multi-dimensional array 
williamr@2
    37
//    interface.
williamr@2
    38
template <typename T, std::size_t NumDims, typename TPtr>
williamr@2
    39
class const_sub_array :
williamr@2
    40
  public boost::detail::multi_array::multi_array_impl_base<T,NumDims>
williamr@2
    41
{
williamr@2
    42
  typedef boost::detail::multi_array::multi_array_impl_base<T,NumDims> super_type;
williamr@2
    43
public: 
williamr@2
    44
  typedef typename super_type::value_type value_type;
williamr@2
    45
  typedef typename super_type::const_reference const_reference;
williamr@2
    46
  typedef typename super_type::const_iterator const_iterator;
williamr@2
    47
  typedef typename super_type::const_reverse_iterator const_reverse_iterator;
williamr@2
    48
  typedef typename super_type::element element;
williamr@2
    49
  typedef typename super_type::size_type size_type;
williamr@2
    50
  typedef typename super_type::difference_type difference_type;
williamr@2
    51
  typedef typename super_type::index index;
williamr@2
    52
  typedef typename super_type::extent_range extent_range;
williamr@2
    53
williamr@2
    54
  // template typedefs
williamr@2
    55
  template <std::size_t NDims>
williamr@2
    56
  struct const_array_view {
williamr@2
    57
    typedef boost::detail::multi_array::const_multi_array_view<T,NDims> type;
williamr@2
    58
  };
williamr@2
    59
williamr@2
    60
  template <std::size_t NDims>
williamr@2
    61
  struct array_view {
williamr@2
    62
    typedef boost::detail::multi_array::multi_array_view<T,NDims> type;
williamr@2
    63
  };
williamr@2
    64
williamr@2
    65
  // Allow default copy constructor as well.
williamr@2
    66
williamr@2
    67
  template <typename OPtr>
williamr@2
    68
  const_sub_array (const const_sub_array<T,NumDims,OPtr>& rhs) :
williamr@2
    69
    base_(rhs.base_), extents_(rhs.extents_), strides_(rhs.strides_),
williamr@2
    70
    index_base_(rhs.index_base_) {
williamr@2
    71
  }
williamr@2
    72
williamr@2
    73
  // const_sub_array always returns const types, regardless of its own
williamr@2
    74
  // constness.
williamr@2
    75
  const_reference operator[](index idx) const {
williamr@2
    76
    return super_type::access(boost::type<const_reference>(),
williamr@2
    77
                              idx,base_,shape(),strides(),index_bases());
williamr@2
    78
  }
williamr@2
    79
  
williamr@2
    80
  template <typename IndexList>
williamr@2
    81
  const element& operator()(const IndexList& indices) const {
williamr@2
    82
    boost::function_requires<
williamr@2
    83
      detail::multi_array::CollectionConcept<IndexList> >();
williamr@2
    84
    return super_type::access_element(boost::type<const element&>(),
williamr@2
    85
                                      indices,origin(),
williamr@2
    86
                                      shape(),strides(),index_bases());
williamr@2
    87
  }
williamr@2
    88
williamr@2
    89
  // see generate_array_view in base.hpp
williamr@2
    90
#if !defined(BOOST_MSVC) || BOOST_MSVC > 1300
williamr@2
    91
  template <int NDims>
williamr@2
    92
#else
williamr@2
    93
  template <int NumDims, int NDims> // else ICE
williamr@2
    94
#endif // BOOST_MSVC
williamr@2
    95
  typename const_array_view<NDims>::type 
williamr@2
    96
  operator[](const boost::detail::multi_array::
williamr@2
    97
             index_gen<NumDims,NDims>& indices)
williamr@2
    98
    const {
williamr@2
    99
    typedef typename const_array_view<NDims>::type return_type;
williamr@2
   100
    return
williamr@2
   101
      super_type::generate_array_view(boost::type<return_type>(),
williamr@2
   102
                                      indices,
williamr@2
   103
                                      shape(),
williamr@2
   104
                                      strides(),
williamr@2
   105
                                      index_bases(),
williamr@2
   106
                                      base_);
williamr@2
   107
  }
williamr@2
   108
williamr@2
   109
  template <typename OPtr>
williamr@2
   110
  bool operator<(const const_sub_array<T,NumDims,OPtr>& rhs) const {
williamr@2
   111
    return std::lexicographical_compare(begin(),end(),rhs.begin(),rhs.end());
williamr@2
   112
  }
williamr@2
   113
williamr@2
   114
  template <typename OPtr>
williamr@2
   115
  bool operator==(const const_sub_array<T,NumDims,OPtr>& rhs) const {
williamr@2
   116
    if(std::equal(shape(),shape()+num_dimensions(),rhs.shape()))
williamr@2
   117
      return std::equal(begin(),end(),rhs.begin());
williamr@2
   118
    else return false;
williamr@2
   119
  }
williamr@2
   120
williamr@2
   121
  template <typename OPtr>
williamr@2
   122
  bool operator!=(const const_sub_array<T,NumDims,OPtr>& rhs) const {
williamr@2
   123
    return !(*this == rhs);
williamr@2
   124
  }
williamr@2
   125
williamr@2
   126
  template <typename OPtr>
williamr@2
   127
  bool operator>(const const_sub_array<T,NumDims,OPtr>& rhs) const {
williamr@2
   128
    return rhs < *this;
williamr@2
   129
  }
williamr@2
   130
williamr@2
   131
  template <typename OPtr>
williamr@2
   132
  bool operator<=(const const_sub_array<T,NumDims,OPtr>& rhs) const {
williamr@2
   133
    return !(*this > rhs);
williamr@2
   134
  }
williamr@2
   135
williamr@2
   136
  template <typename OPtr>
williamr@2
   137
  bool operator>=(const const_sub_array<T,NumDims,OPtr>& rhs) const {
williamr@2
   138
    return !(*this < rhs);
williamr@2
   139
  }
williamr@2
   140
williamr@2
   141
  const_iterator begin() const {
williamr@2
   142
    return const_iterator(*index_bases(),origin(),
williamr@2
   143
                          shape(),strides(),index_bases());
williamr@2
   144
  }
williamr@2
   145
williamr@2
   146
  const_iterator end() const {
williamr@2
   147
    return const_iterator(*index_bases()+(index)*shape(),origin(),
williamr@2
   148
                          shape(),strides(),index_bases());
williamr@2
   149
  }
williamr@2
   150
williamr@2
   151
  const_reverse_iterator rbegin() const {
williamr@2
   152
    return const_reverse_iterator(end());
williamr@2
   153
  }
williamr@2
   154
williamr@2
   155
  const_reverse_iterator rend() const {
williamr@2
   156
    return const_reverse_iterator(begin());
williamr@2
   157
  }
williamr@2
   158
williamr@2
   159
  TPtr origin() const { return base_; }
williamr@2
   160
  size_type size() const { return extents_[0]; }
williamr@2
   161
  size_type max_size() const { return num_elements(); }
williamr@2
   162
  bool empty() const { return size() == 0; }
williamr@2
   163
  size_type num_dimensions() const { return NumDims; }
williamr@2
   164
  const size_type*  shape() const { return extents_; }
williamr@2
   165
  const index* strides() const { return strides_; }
williamr@2
   166
  const index* index_bases() const { return index_base_; }
williamr@2
   167
williamr@2
   168
  size_type num_elements() const { 
williamr@2
   169
    return std::accumulate(shape(),shape() + num_dimensions(),
williamr@2
   170
                           size_type(1), std::multiplies<size_type>());
williamr@2
   171
  }
williamr@2
   172
williamr@2
   173
williamr@2
   174
#ifndef BOOST_NO_MEMBER_TEMPLATE_FRIENDS
williamr@2
   175
protected:
williamr@2
   176
  template <typename,std::size_t> friend class value_accessor_n;  
williamr@2
   177
  template <typename,std::size_t,typename> friend class const_sub_array;
williamr@2
   178
#else    
williamr@2
   179
public:  // Should be protected
williamr@2
   180
#endif
williamr@2
   181
williamr@2
   182
  const_sub_array (TPtr base,
williamr@2
   183
                 const size_type* extents,
williamr@2
   184
                 const index* strides,
williamr@2
   185
                 const index* index_base) :
williamr@2
   186
    base_(base), extents_(extents), strides_(strides),
williamr@2
   187
    index_base_(index_base) {
williamr@2
   188
  }
williamr@2
   189
williamr@2
   190
  TPtr base_;
williamr@2
   191
  const size_type* extents_;
williamr@2
   192
  const index* strides_;
williamr@2
   193
  const index* index_base_;
williamr@2
   194
private:
williamr@2
   195
  // const_sub_array cannot be assigned to (no deep copies!)
williamr@2
   196
  const_sub_array& operator=(const const_sub_array&);
williamr@2
   197
};
williamr@2
   198
williamr@2
   199
williamr@2
   200
//
williamr@2
   201
// sub_array
williamr@2
   202
//    multi_array's proxy class to allow multiple overloads of
williamr@2
   203
//    operator[] in order to provide a clean multi-dimensional array 
williamr@2
   204
//    interface.
williamr@2
   205
template <typename T, std::size_t NumDims>
williamr@2
   206
class sub_array : public const_sub_array<T,NumDims,T*>
williamr@2
   207
{
williamr@2
   208
  typedef const_sub_array<T,NumDims,T*> super_type;
williamr@2
   209
public: 
williamr@2
   210
  typedef typename super_type::element element;
williamr@2
   211
  typedef typename super_type::reference reference;
williamr@2
   212
  typedef typename super_type::index index;
williamr@2
   213
  typedef typename super_type::size_type size_type;
williamr@2
   214
  typedef typename super_type::iterator iterator;
williamr@2
   215
  typedef typename super_type::reverse_iterator reverse_iterator;
williamr@2
   216
  typedef typename super_type::const_reference const_reference;
williamr@2
   217
  typedef typename super_type::const_iterator const_iterator;
williamr@2
   218
  typedef typename super_type::const_reverse_iterator const_reverse_iterator;
williamr@2
   219
williamr@2
   220
  // template typedefs
williamr@2
   221
  template <std::size_t NDims>
williamr@2
   222
  struct const_array_view {
williamr@2
   223
    typedef boost::detail::multi_array::const_multi_array_view<T,NDims> type;
williamr@2
   224
  };
williamr@2
   225
williamr@2
   226
  template <std::size_t NDims>
williamr@2
   227
  struct array_view {
williamr@2
   228
    typedef boost::detail::multi_array::multi_array_view<T,NDims> type;
williamr@2
   229
  };
williamr@2
   230
williamr@2
   231
  // Assignment from other ConstMultiArray types.
williamr@2
   232
  template <typename ConstMultiArray>
williamr@2
   233
  sub_array& operator=(const ConstMultiArray& other) {
williamr@2
   234
    function_requires< boost::detail::multi_array::ConstMultiArrayConcept< 
williamr@2
   235
        ConstMultiArray, NumDims> >();
williamr@2
   236
williamr@2
   237
    // make sure the dimensions agree
williamr@2
   238
    assert(other.num_dimensions() == this->num_dimensions());
williamr@2
   239
    assert(std::equal(other.shape(),other.shape()+this->num_dimensions(),
williamr@2
   240
                      this->shape()));
williamr@2
   241
    // iterator-based copy
williamr@2
   242
    std::copy(other.begin(),other.end(),begin());
williamr@2
   243
    return *this;
williamr@2
   244
  }
williamr@2
   245
williamr@2
   246
williamr@2
   247
  sub_array& operator=(const sub_array& other) {
williamr@2
   248
    if (&other != this) {
williamr@2
   249
      // make sure the dimensions agree
williamr@2
   250
      assert(other.num_dimensions() == this->num_dimensions());
williamr@2
   251
      assert(std::equal(other.shape(),other.shape()+this->num_dimensions(),
williamr@2
   252
                        this->shape()));
williamr@2
   253
      // iterator-based copy
williamr@2
   254
      std::copy(other.begin(),other.end(),begin());
williamr@2
   255
    }
williamr@2
   256
    return *this;
williamr@2
   257
  }
williamr@2
   258
williamr@2
   259
  T* origin() { return this->base_; }
williamr@2
   260
  const T* origin() const { return this->base_; }
williamr@2
   261
williamr@2
   262
  reference operator[](index idx) {
williamr@2
   263
    return super_type::access(boost::type<reference>(),
williamr@2
   264
                              idx,this->base_,this->shape(),this->strides(),
williamr@2
   265
                              this->index_bases());
williamr@2
   266
  }
williamr@2
   267
williamr@2
   268
  // see generate_array_view in base.hpp
williamr@2
   269
#if !defined(BOOST_MSVC) || BOOST_MSVC > 1300
williamr@2
   270
  template <int NDims>
williamr@2
   271
#else
williamr@2
   272
  template <int NumDims, int NDims> // else ICE
williamr@2
   273
#endif // BOOST_MSVC
williamr@2
   274
  typename array_view<NDims>::type 
williamr@2
   275
  operator[](const boost::detail::multi_array::
williamr@2
   276
             index_gen<NumDims,NDims>& indices) {
williamr@2
   277
    typedef typename array_view<NDims>::type return_type;
williamr@2
   278
    return
williamr@2
   279
      super_type::generate_array_view(boost::type<return_type>(),
williamr@2
   280
                                      indices,
williamr@2
   281
                                      this->shape(),
williamr@2
   282
                                      this->strides(),
williamr@2
   283
                                      this->index_bases(),
williamr@2
   284
                                      origin());
williamr@2
   285
  }
williamr@2
   286
williamr@2
   287
  template <class IndexList>
williamr@2
   288
  element& operator()(const IndexList& indices) {
williamr@2
   289
    boost::function_requires<
williamr@2
   290
      detail::multi_array::CollectionConcept<IndexList> >();
williamr@2
   291
    return super_type::access_element(boost::type<element&>(),
williamr@2
   292
                                      indices,origin(),
williamr@2
   293
                                      this->shape(),this->strides(),
williamr@2
   294
                                      this->index_bases());
williamr@2
   295
  }
williamr@2
   296
williamr@2
   297
  iterator begin() {
williamr@2
   298
    return iterator(*this->index_bases(),origin(),
williamr@2
   299
                    this->shape(),this->strides(),this->index_bases());
williamr@2
   300
  }
williamr@2
   301
williamr@2
   302
  iterator end() {
williamr@2
   303
    return iterator(*this->index_bases()+(index)*this->shape(),origin(),
williamr@2
   304
                    this->shape(),this->strides(),this->index_bases());
williamr@2
   305
  }
williamr@2
   306
williamr@2
   307
  // RG - rbegin() and rend() written naively to thwart MSVC ICE.
williamr@2
   308
  reverse_iterator rbegin() {
williamr@2
   309
    reverse_iterator ri(end());
williamr@2
   310
    return ri;
williamr@2
   311
  }
williamr@2
   312
williamr@2
   313
  reverse_iterator rend() {
williamr@2
   314
    reverse_iterator ri(begin());
williamr@2
   315
    return ri;
williamr@2
   316
  }
williamr@2
   317
williamr@2
   318
  //
williamr@2
   319
  // proxies
williamr@2
   320
  //
williamr@2
   321
williamr@2
   322
  template <class IndexList>
williamr@2
   323
  const element& operator()(const IndexList& indices) const {
williamr@2
   324
    boost::function_requires<
williamr@2
   325
      detail::multi_array::CollectionConcept<IndexList> >();
williamr@2
   326
    return super_type::operator()(indices);
williamr@2
   327
  }
williamr@2
   328
williamr@2
   329
  const_reference operator[](index idx) const {
williamr@2
   330
    return super_type::operator[](idx);
williamr@2
   331
  }
williamr@2
   332
williamr@2
   333
  // see generate_array_view in base.hpp
williamr@2
   334
#if !defined(BOOST_MSVC) || BOOST_MSVC > 1300
williamr@2
   335
  template <int NDims>
williamr@2
   336
#else
williamr@2
   337
  template <int NumDims, int NDims> // else ICE
williamr@2
   338
#endif // BOOST_MSVC
williamr@2
   339
  typename const_array_view<NDims>::type 
williamr@2
   340
  operator[](const boost::detail::multi_array::
williamr@2
   341
             index_gen<NumDims,NDims>& indices)
williamr@2
   342
    const {
williamr@2
   343
    return super_type::operator[](indices);
williamr@2
   344
  }
williamr@2
   345
williamr@2
   346
  const_iterator begin() const {
williamr@2
   347
    return super_type::begin();
williamr@2
   348
  }
williamr@2
   349
  
williamr@2
   350
  const_iterator end() const {
williamr@2
   351
    return super_type::end();
williamr@2
   352
  }
williamr@2
   353
williamr@2
   354
  const_reverse_iterator rbegin() const {
williamr@2
   355
    return super_type::rbegin();
williamr@2
   356
  }
williamr@2
   357
williamr@2
   358
  const_reverse_iterator rend() const {
williamr@2
   359
    return super_type::rend();
williamr@2
   360
  }
williamr@2
   361
williamr@2
   362
#ifndef BOOST_NO_MEMBER_TEMPLATE_FRIENDS
williamr@2
   363
private:
williamr@2
   364
  template <typename,std::size_t> friend class value_accessor_n;
williamr@2
   365
#else
williamr@2
   366
public: // should be private
williamr@2
   367
#endif
williamr@2
   368
williamr@2
   369
  sub_array (T* base,
williamr@2
   370
            const size_type* extents,
williamr@2
   371
            const index* strides,
williamr@2
   372
            const index* index_base) :
williamr@2
   373
    super_type(base,extents,strides,index_base) {
williamr@2
   374
  }
williamr@2
   375
williamr@2
   376
};
williamr@2
   377
williamr@2
   378
} // namespace multi_array
williamr@2
   379
} // namespace detail
williamr@2
   380
//
williamr@2
   381
// traits classes to get sub_array types
williamr@2
   382
//
williamr@2
   383
template <typename Array, int N>
williamr@2
   384
class subarray_gen {
williamr@2
   385
  typedef typename Array::element element;
williamr@2
   386
public:
williamr@2
   387
  typedef boost::detail::multi_array::sub_array<element,N> type;
williamr@2
   388
};
williamr@2
   389
williamr@2
   390
template <typename Array, int N>
williamr@2
   391
class const_subarray_gen {
williamr@2
   392
  typedef typename Array::element element;
williamr@2
   393
public:
williamr@2
   394
  typedef boost::detail::multi_array::const_sub_array<element,N> type;  
williamr@2
   395
};
williamr@2
   396
} // namespace boost
williamr@2
   397
  
williamr@2
   398
#endif // SUBARRAY_RG071801_HPP