pw::Deallocator Class Reference

Abstract interface for releasing memory. More...

#include <deallocator.h>

Public Types
using	Capabilities = allocator::Capabilities
using	Capability = allocator::Capability
using	Layout = allocator::Layout

Public Member Functions
const Capabilities &	capabilities () const
bool	HasCapability (Capability capability) const
	Returns whether a given capabilityis enabled for this object.
void	Deallocate (void *ptr)
void	Deallocate (void *ptr, Layout layout)
template<typename T >
void	Delete (T *ptr)
StatusWithSize	GetCapacity () const
bool	IsEqual (const Deallocator &other) const

Protected Member Functions
constexpr	Deallocator ()=default
	TODO(b/326509341): Remove when downstream consumers migrate.
constexpr	Deallocator (const Capabilities &capabilities)
template<typename T >
UniquePtr< T >	WrapUnique (T *ptr)

Detailed Description

Abstract interface for releasing memory.

Member Function Documentation

Deallocate() [1/2]

void pw::Deallocator::Deallocate ( void *  ptr )

inline

Releases a previously-allocated block of memory.

The given pointer must have been previously provided by this memory resource; otherwise the behavior is undefined.

Parameters

[in]

ptr

Pointer to previously-allocated memory.

Deallocate() [2/2]

void pw::Deallocator::Deallocate ( void *  ptr, Layout  layout  )

inline

Deprecated version of Deallocate that takes a Layout. Do not use this method. It will be removed. TODO(b/326509341): Remove when downstream consumers migrate.

Delete()

template<typename T >

void pw::Deallocator::Delete ( T *  ptr )

inline

Destroys the object at ptr and deallocates the associated memory.

The given pointer must have been previously obtained from a call to New using the same object; otherwise the behavior is undefined.

Parameters

[in]

ptr

Pointer to previously-allocated object.

GetCapacity()

StatusWithSize pw::Deallocator::GetCapacity ( ) const

inline

Returns the total amount of memory provided by this object.

This is an optional method. Some memory providers may not have an easily defined capacity, e.g. the system allocator. If implemented, the returned capacity may be less than the memory originally given to an allocator, e.g. if the allocator must align the region of memory, its capacity may be reduced.

IsEqual()

bool pw::Deallocator::IsEqual ( const Deallocator &  other ) const

inline

Returns whether the given object is the same as this one.

This method is used instead of operator== in keeping with std::pmr::memory_resource::is_equal. There currently is no corresponding virtual DoIsEqual, as objects that would require dynamic_cast to properly determine equality are not supported. This method will allow the interface to remain unchanged should a future need for such objects arise.

Parameters

[in]

other

Object to compare with this object.

WrapUnique()

template<typename T >

UniquePtr< T > pw::Deallocator::WrapUnique ( T *  ptr )

inlineprotected

Wraps an object of type T in a UniquePtr

Parameters

[in]

ptr

Pointer to memory provided by this object.

---

The documentation for this class was generated from the following file:

• /b/s/w/ir/x/w/co/pw_allocator/public/pw_allocator/deallocator.h