asioext::hook_allocator< T, Handler > Class Template Reference

Allocator that uses a handler's memory allocation hooks. More...

#include <asioext/associated_allocator.hpp>

Public Types
typedef T	value_type

Public Member Functions
	hook_allocator (Handler &h) noexcept
template<typename U >
	hook_allocator (const hook_allocator< U, Handler > &a) noexcept
T *	allocate (std::size_t n)
void	deallocate (T *p, std::size_t n)

Friends
template<class U , typename Handler2 >
class	hook_allocator
template<class U >
bool	operator== (const hook_allocator &, const hook_allocator< U, Handler > &) noexcept
template<class U >
bool	operator!= (const hook_allocator &, const hook_allocator< U, Handler > &) noexcept

Detailed Description

template<typename T, typename Handler>
class asioext::hook_allocator< T, Handler >

Allocator that uses a handler's memory allocation hooks.

Asio Handlers (before Asio 1.11.0+) use two hooks to allow memory allocation to be customized:

• asio_handler_allocate()
• asio_handler_deallocate()

This stateless allocator uses these hooks to allocate/free memory.

Note

The allocated memory's lifetime is dependent on the handler's lifetime. All memory must be de-allocated before the user's handler is invoked ([async.reqmts.async.alloc]).

Member Typedef Documentation

value_type

template<typename T, typename Handler>

typedef T asioext::hook_allocator< T, Handler >::value_type

Constructor & Destructor Documentation

hook_allocator() [1/2]

template<typename T, typename Handler>

asioext::hook_allocator< T, Handler >::hook_allocator ( Handler &  h )

inlineexplicitnoexcept

hook_allocator() [2/2]

template<typename T, typename Handler>

template<typename U >

asioext::hook_allocator< T, Handler >::hook_allocator ( const hook_allocator< U, Handler > &  a )

inlinenoexcept

Member Function Documentation

allocate()

template<typename T, typename Handler>

T* asioext::hook_allocator< T, Handler >::allocate ( std::size_t  n )

inline

deallocate()

template<typename T, typename Handler>

void asioext::hook_allocator< T, Handler >::deallocate ( T *  p, std::size_t  n  )

inline

Friends And Related Function Documentation

hook_allocator

template<typename T, typename Handler>

template<class U , typename Handler2 >

friend class hook_allocator

friend

operator!=

template<typename T, typename Handler>

template<class U >

bool operator!= ( const hook_allocator< T, Handler > &  a, const hook_allocator< U, Handler > &  b  )

friend

operator==

template<typename T, typename Handler>

template<class U >

bool operator== ( const hook_allocator< T, Handler > &  a, const hook_allocator< U, Handler > &  b  )

friend