memory_pool.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: MIT
// Copyright (c) 2026 Daniel Polo
 
#ifndef IT_D4NP_MEMORYPOOL_MEMORY_POOL_HPP_
#define IT_D4NP_MEMORYPOOL_MEMORY_POOL_HPP_
 
#include <it/d4np/memorypool/memory_pool.h>
 
#include <cstddef>
#include <optional>
 
namespace it::d4np::memorypool {
 
class Pool {
public:
    Pool(std::size_t block_size, std::size_t block_count);
 
    [[nodiscard]] static std::optional<Pool> make(std::size_t block_size, std::size_t block_count);
 
    [[nodiscard]] static std::optional<Pool> make_dynamic(std::size_t block_size, std::size_t block_count,
                                                          std::size_t growth_factor);
 
    ~Pool() noexcept;
 
    Pool(const Pool&) = delete;
    Pool& operator=(const Pool&) = delete;
 
    Pool(Pool&& other) noexcept;
 
    Pool& operator=(Pool&& other) noexcept;
 
    [[nodiscard]] void* allocate();
 
    [[nodiscard]] void* try_allocate() noexcept;
 
    void deallocate(void* block) noexcept;
 
    memory_pool_t* native_handle() noexcept;
 
    [[nodiscard]] std::size_t metadata_bytes() const noexcept;
 
    [[nodiscard]] std::size_t block_size() const noexcept;
 
private:
    explicit Pool(memory_pool_t* handle) noexcept;
 
    memory_pool_t* handle_;
};
 
class PoolBuilder {
public:
    PoolBuilder& with_block_size(std::size_t block_size) noexcept;
 
    PoolBuilder& with_block_count(std::size_t block_count) noexcept;
 
    PoolBuilder& with_growth_factor(std::size_t growth_factor) noexcept;
 
    [[nodiscard]] std::optional<Pool> build() const;
 
private:
    std::size_t block_size_ = 0;
    std::size_t block_count_ = 0;
    std::size_t growth_factor_ = 0;
};
 
}  // namespace it::d4np::memorypool
 
#endif  // IT_D4NP_MEMORYPOOL_MEMORY_POOL_HPP_