mi32/micachearray.h

Go to the documentation of this file.

#ifndef  INC_MI32_MICACHEARRAY_H
#define  INC_MI32_MICACHEARRAY_H

#ifndef  INC_MI32_MICACHE_H
#include <mi32/micache.h>
#endif

#ifndef GENERATING_DOXYGEN_OUTPUT
template <class _CT> class MICACHEARRAYIO;
#endif 

template <class _CT>
class MICACHEARRAY : private MICACHEIO {
   public:
      explicit MICACHEARRAY (MICACHEARRAYIO<_CT>& ioref) : m_ioref(ioref), m_ItemSize(0), m_NumItemsInCacheEntry(0) {}
      
      virtual ~MICACHEARRAY () {}
   
      ERRVALUE Create (
         INT32 NumBuckets,                   
         INT32 BucketSize = 32768,           
         bool bSynchronizeAccess = false,    
         INT32 ItemSize = sizeof(_CT)        
         ) {
         m_ItemSize = ItemSize;
         m_NumItemsInCacheEntry = BucketSize / ItemSize;
         return (m_Cache.Create(NumBuckets, m_NumItemsInCacheEntry * ItemSize, *this, 0, bSynchronizeAccess));
         }
   
      ERRVALUE Flush (
         ) { return (m_Cache.Flush()); }
         
      void Free (
         ) { m_Cache.Free(); }

      ERRVALUE Read (
         INT32 ItemIdx,                   
         _CT& item,                       
         void* UserDataPtr = 0            
         ) { 
         INT32 ItemID = ItemIdx / m_NumItemsInCacheEntry;
         INT32 Offset = (ItemIdx % m_NumItemsInCacheEntry) * m_ItemSize;
         return (m_Cache.Read(ItemID, Offset, m_ItemSize, &item, UserDataPtr));
         }

      ERRVALUE Write (
         INT32 ItemIdx,                   
         const _CT& item,                 
         void* UserDataPtr = 0            
         ) { 
         INT32 ItemID = ItemIdx / m_NumItemsInCacheEntry;
         INT32 Offset = (ItemIdx % m_NumItemsInCacheEntry) * m_ItemSize;
         return (m_Cache.Write(ItemID, Offset, m_ItemSize, &item, UserDataPtr));
         }

   private:
      #ifndef GENERATING_DOXYGEN_OUTPUT
      MICACHE m_Cache;
      MICACHEARRAYIO<_CT>& m_ioref;
      UINT32 m_ItemSize;
      UINT32 m_NumItemsInCacheEntry;
      
      ERRVALUE CacheLoad (
         MICACHE::ITEMINFO& iteminfo
         ) { return (m_ioref.ArrayLoad(iteminfo.GetItemID() * m_NumItemsInCacheEntry, m_ItemSize, m_NumItemsInCacheEntry, static_cast<_CT*>(iteminfo.GetMemPtr()))); }
         
      ERRVALUE CacheSave (
         MICACHE::ITEMINFO& iteminfo
         ) { return (m_ioref.ArraySave(iteminfo.GetItemID() * m_NumItemsInCacheEntry, m_ItemSize, m_NumItemsInCacheEntry, static_cast<const _CT*>(iteminfo.GetMemPtr()))); }
      #endif // GENERATING_DOXYGEN_OUTPUT
   };


template <class _CT>
class MICACHEARRAYIO {
   protected:
      virtual ERRVALUE ArrayLoad (
         INT32 ItemIdx,
         INT32 ItemSize,      
         INT32 NumItems,
         _CT* BucketPtr 
         ) = 0;

      virtual ERRVALUE ArraySave (
         INT32 ItemIdx,
         INT32 ItemSize,      
         INT32 NumItems,
         const _CT* BucketPtr
         ) = 0;
   friend class MICACHEARRAY<_CT>;
   };

#endif   // INC_MI32_MICACHEARRAY_H

---