snmalloc-sys 0.7.4

rust raw bindings of snmalloc.
Documentation
#pragma once

/**
 * This header requires that Alloc has been defined.
 */

namespace snmalloc
{
  /**
   * RAII wrapper around an `Alloc`.  This class gets an allocator from the
   * global pool and wraps it so that `Alloc` methods can be called
   * directly via the `->` operator on this class.  When this object is
   * destroyed, it returns the allocator to the global pool.
   *
   * This does not depend on thread-local storage working, so can be used for
   * bootstrapping.
   */
  template<typename SAlloc = Alloc>
  struct ScopedAllocator
  {
    /**
     * The allocator that this wrapper will use.
     */
    SAlloc* alloc;

    /**
     * Constructor.  Claims an allocator from the global pool
     */
    ScopedAllocator()
    {
      alloc = AllocPool<typename SAlloc::Config>::acquire();
    };

    /**
     * Copying is not supported, it could easily lead to accidental sharing of
     * allocators.
     */
    ScopedAllocator(const ScopedAllocator&) = delete;

    /**
     * Moving is not supported, though it would be easy to add if there's a use
     * case for it.
     */
    ScopedAllocator(ScopedAllocator&&) = delete;

    /**
     * Copying is not supported, it could easily lead to accidental sharing of
     * allocators.
     */
    ScopedAllocator& operator=(const ScopedAllocator&) = delete;

    /**
     * Moving is not supported, though it would be easy to add if there's a use
     * case for it.
     */
    ScopedAllocator& operator=(ScopedAllocator&&) = delete;

    /**
     * Destructor.  Returns the allocator to the pool.
     */
    ~ScopedAllocator()
    {
      if (alloc != nullptr)
      {
        alloc->flush();
        AllocPool<typename SAlloc::Config>::release(alloc);
        alloc = nullptr;
      }
    }

    /**
     * Arrow operator, allows methods exposed by `Alloc` to be called on the
     * wrapper.
     */
    SAlloc* operator->()
    {
      return alloc;
    }
  };

  /**
   * Returns a new scoped allocator.  When the `ScopedAllocator` goes out of
   * scope, the underlying `Alloc` will be returned to the pool.
   */
  template<typename SAlloc = Alloc>
  inline ScopedAllocator<SAlloc> get_scoped_allocator()
  {
    return {};
  }
} // namespace snmalloc