mysql::allocators::Allocator< T > Class Template Reference

Allocator using a Memory_resource to do the allocator. More...

#include <allocator.h>

Public Types
using	value_type = T
using	size_type = std::size_t
using	difference_type = std::ptrdiff_t

Public Member Functions
	Allocator (Memory_resource memory_resource=Memory_resource())
	Construct a new Allocator using the given Memory_resource. More...
template<class U >
	Allocator (const Allocator< U > &other)
	Implicit conversion from other instance. More...
constexpr T *	allocate (size_type n)
	Use the Memory_resource to allocate the given number of elements of type T. More...
constexpr void	deallocate (T *p, size_type size)
	Use the Memory_resource to deallocate the given pointer. More...
std::function< void(T *)>	get_deleter ()
	Return a Deleter function for objects allocated by this class. More...
Memory_resource	get_memory_resource () const
	Return the underlying Memory_resource object. More...

Private Attributes
const Memory_resource	m_memory_resource
	The underlying Memory_resource object. More...

Detailed Description

template<class T>
class mysql::allocators::Allocator< T >

Allocator using a Memory_resource to do the allocator.

A library that allocates memory should allow the user to pass a Memory_resource object which defaults to a default-constructed instance, Memory_resource(). Internally it should create the Allocator<T> classes it needs (possibly several, for different classes T), using the given Memory_resource object. Users of the library outside the server should just use the default Memory_resource. Users of the library inside the server should setup a PSI key and pass the result from memory_resource(Key) to the library.

Member Typedef Documentation

difference_type

template<class T >

using mysql::allocators::Allocator< T >::difference_type = std::ptrdiff_t

size_type

template<class T >

using mysql::allocators::Allocator< T >::size_type = std::size_t

value_type

template<class T >

using mysql::allocators::Allocator< T >::value_type = T

Constructor & Destructor Documentation

Allocator() [1/2]

template<class T >

mysql::allocators::Allocator< T >::Allocator ( Memory_resource  memory_resource = Memory_resource() )

inlineexplicit

Construct a new Allocator using the given Memory_resource.

Parameters

memory_resource

The memory resource. By default, this uses a default-constructed Memory_resource, so it uses std::malloc and std::free for allocations.

Allocator() [2/2]

template<class T >

template<class U >

mysql::allocators::Allocator< T >::Allocator ( const Allocator< U > &  other )

inlineexplicit

Implicit conversion from other instance.

This is required by Windows implementation of std::vector<Allocator>.

Member Function Documentation

allocate()

template<class T >

constexpr T * mysql::allocators::Allocator< T >::allocate ( size_type  n )

inlineconstexpr

Use the Memory_resource to allocate the given number of elements of type T.

Parameters

n	The number of elements.

Returns

The new pointer.

Exceptions

std::bad_alloc

on out of memory conditions.

deallocate()

template<class T >

constexpr void mysql::allocators::Allocator< T >::deallocate ( T *  p, size_type  size  )

inlineconstexpr

Use the Memory_resource to deallocate the given pointer.

Parameters

p	The pointer to deallocate.
size	Unused.

get_deleter()

template<class T >

std::function< void(T *)> mysql::allocators::Allocator< T >::get_deleter ( )

inline

Return a Deleter function for objects allocated by this class.

Such a Deleter must be specified when constructing a smart pointer to an object created by this Allocator, for example:

Allocator<T> allocator(some_memory_resource);
T *obj = allocator.allocate(1);
std::shared_ptr<T> ptr(obj, allocator.get_deleter());

Return values

Deleter

function that takes a T* as argument and uses the Memory_resource to deallocate it.

get_memory_resource()

template<class T >

Memory_resource mysql::allocators::Allocator< T >::get_memory_resource ( ) const

inline

Return the underlying Memory_resource object.

Member Data Documentation

m_memory_resource

template<class T >

const Memory_resource mysql::allocators::Allocator< T >::m_memory_resource

private

The underlying Memory_resource object.

---

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

• libs/mysql/allocators/allocator.h