index-iter.hpp

Go to the documentation of this file.

/*
  INDEX-ITER.hpp  -  iterator with indexed random-access to referred container
 
   Copyright (C)
     2024,            Hermann Vosseler <Ichthyostega@web.de>
 
 **Lumiera** is free software; you can redistribute it and/or modify it
 under the terms of the GNU General Public License as published by the
 Free Software Foundation; either version 2 of the License, or (at your
 option) any later version. See the file COPYING for further details.
 
*/
 
 
#ifndef SRC_LIB_INDEX_ITER_H
#define SRC_LIB_INDEX_ITER_H
 
 
#include "lib/iter-adapter.hpp"
 
 
namespace lib {
  namespace iter {
    
    template<typename PTR>
    struct IndexAccessCore
      {
        PTR    data_{};
        size_t idx_{0};
        
        using ResVal = decltype(data_->operator[](0));
        
        using value_type = meta::RefTraits<ResVal>::Value;
        using reference  = meta::RefTraits<ResVal>::Reference;
        
        bool
        checkPoint() const
          {
            return isValidIDX(idx_);
          }
        
        reference
        yield()  const
          {
            return (*data_)[idx_];
          }
        
        void
        iterNext()
          {
            ++idx_;
          }
        
        
        bool
        isValidIDX (size_t idx)  const
          {
            return bool(data_)
               and idx < data_->size();
          }
        
        using IterWrapper = lib::IterStateWrapper<IndexAccessCore>;
        
        
        friend bool operator== (IndexAccessCore const& c1, IndexAccessCore const& c2)
        {
          return c1.data_ == c2.data_ and (not c1.data_ or c1.idx_ == c2.idx_);
        }
        friend bool operator!= (IndexAccessCore const& c1, IndexAccessCore const& c2)
        {
          return not (c1 == c2);
        }
      };
    //
  }//(End)Implementation
  
  
  
  template<class CON, typename PTR = CON*>
  class IndexIter
    : public iter::IndexAccessCore<PTR>::IterWrapper
    {
      using _Cor = iter::IndexAccessCore<PTR>;
      using _Par = _Cor::IterWrapper;
      
    public:
      IndexIter()  = default;
      IndexIter (CON& container)  : IndexIter{&container}{ };
      IndexIter (PTR pContainer)
        : _Par{_Cor{pContainer, 0}}
        { }
      
      
      size_t
      getIDX()  const
        {
          _Par::__throw_if_empty();
          return _Par::stateCore().idx_;
        }
      
      void
      setIDX (size_t newIDX)
        {
          auto& core = _Par::stateCore();
          if (not core.isValidIDX (newIDX))
            throw lumiera::error::Invalid ("Attempt to set index out of bounds",
                  lumiera::error::LUMIERA_ERROR_INDEX_BOUNDS);
          core.idx_ = newIDX;
        }
    };
  
  
} // namespace lib
#endif /*SRC_LIB_INDEX_ITER_H*/