IndexedPayloadArena.h

 
#ifndef MFRAME_6B8EAE16_5470_4A62_A67B_182F60466B41
#define MFRAME_6B8EAE16_5470_4A62_A67B_182F60466B41
 
/* ***************************************************************************************
 * Include
 */
 
//----------------------------------------------------------------------------------------
#include "./../lang/Memory.h"
#include "./../lang/Object.h"
#include "./../util/Container.h"
 
//----------------------------------------------------------------------------------------
 
/* ***************************************************************************************
 * Namespace
 */
namespace ufm::util {
  class IndexedPayloadArena;
}  // namespace ufm::util
 
/* ***************************************************************************************
 * Class/Interface/Struct/Enum
 */
 
class ufm::util::IndexedPayloadArena : public ufm::lang::Object,
                                       public ufm::util::Container {
  /* *************************************************************************************
   * Class/Interface/Struct/Enum
   */
 public:
  struct Handle;  // 記憶體區塊控制結構，用於追蹤每個資料塊的元數據
 
  /* *************************************************************************************
   * Variable
   */
 private:
  ufm::lang::Memory vMemory;  
  uint16            vSize;    
  uint16            vLength;  
 
  /* *************************************************************************************
   * Abstract Method
   */
 
  /* *************************************************************************************
   * Construct Method
   */
 public:
  IndexedPayloadArena(ufm::lang::Memory memory);
 
  virtual ~IndexedPayloadArena(void) override;
 
  /* *************************************************************************************
   * Operator Method
   */
 
  /* *************************************************************************************
   * Override - ufm::util::Container
   */
 public:
  virtual void clear(void) override;
 
  virtual bool isEmpty(void) const override;
 
  virtual int size(void) const override;
 
  /* *************************************************************************************
   * Public Method
   */
 public:
  template <typename T, size_t N>
  inline bool insert(T (&array)[N], int index) {
    return this->insert(&array[0], static_cast<int>(N * sizeof(T)), index);
  }
 
  bool insert(const void* data, int length, int index);
 
  bool remove(int index);
 
  int get(void*& data, int index) const;
 
  template <typename T>
  int get(T*& data, int index) const {
    void* raw = nullptr;
    int result = this->get(raw, index);
    data = static_cast<T*>(raw);  // 或 reinterpret_cast<T*>(raw)，取決於實際需求
    return result;
  }
 
  template <typename T, size_t N>
  inline bool set(T (&array)[N], int index) {
    return this->set(&array[0], static_cast<int>(N * sizeof(T)), index);
  }
 
  bool set(const void* data, int length, int index);
 
  int availableGap(void) const;
 
  int compact(void);
 
  /* *************************************************************************************
   * Public Method
   */
 
  /* *************************************************************************************
   * Protected Method
   */
 
  /* *************************************************************************************
   * Private Method
   */
 
  /* *************************************************************************************
   * Static Variable
   */
 public:
  static constexpr uint16 ELEMENT_SHIFT = 3;  
  static constexpr uint16 ELEMENT_MASK  = ((1 << ELEMENT_SHIFT) - 1);  
 
  /* *************************************************************************************
   * Static Method
   */
};
 
struct ufm::util::IndexedPayloadArena::Handle {
  uint16 capacity;  
  uint16 length;    
  uint16 offset;    
  uint16 index;     
};
 
/* ***************************************************************************************
 * End of file
 */
 
#endif /* MFRAME_6B8EAE16_5470_4A62_A67B_182F60466B41 */