thrust::mr::allocator

template<typename T, class MR>
class allocator : private thrust::mr::validator<MR>

An mr::allocator is a template that fulfills the C++ requirements for Allocators, allowing to use the NPA-based memory resources where an Allocator is required. Unlike memory resources, but like other allocators, mr::allocator is typed and bound to allocate object of a specific type, however it can be freely rebound to other types.

Template Parameters:

• T – the type that will be allocated by this allocator.

• MR – the upstream memory resource to use for memory allocation. Must derive from thrust::mr::memory_resource and must be final (in C++11 and beyond).

Subclassed by thrust::mr::stateless_resource_allocator< T, device_ptr_memory_resource< device_memory_resource > >

Public Types

using void_pointer = typename MR::pointer

The pointer to void type of this allocator.

using value_type = T

The value type allocated by this allocator. Equivalent to T.

using pointer = typename thrust::detail::pointer_traits<void_pointer>::template rebind<T>::other

The pointer type allocated by this allocator. Equivaled to the pointer type of MR rebound to T.

using const_pointer = typename thrust::detail::pointer_traits<void_pointer>::template rebind<const T>::other

The pointer to const type. Equivalent to a pointer type of MR rebound to const T.

using reference = typename thrust::detail::pointer_traits<pointer>::reference

The reference to the type allocated by this allocator. Supports smart references.

using const_reference = typename thrust::detail::pointer_traits<const_pointer>::reference

The const reference to the type allocated by this allocator. Supports smart references.

using size_type = std::size_t

The size type of this allocator. Always std::size_t.

using difference_type = typename thrust::detail::pointer_traits<pointer>::difference_type

The difference type between pointers allocated by this allocator.

using propagate_on_container_copy_assignment = detail::true_type

Specifies that the allocator shall be propagated on container copy assignment.

using propagate_on_container_move_assignment = detail::true_type

Specifies that the allocator shall be propagated on container move assignment.

using propagate_on_container_swap = detail::true_type

Specifies that the allocator shall be propagated on container swap.

Public Functions

inline size_type max_size() const

Calculates the maximum number of elements allocated by this allocator.

Returns:

the maximum value of std::size_t, divided by the size of T.

inline allocator(MR *resource)

Constructor.

Parameters:

resource – the resource to be used to allocate raw memory.

template<typename U>
inline allocator(

const allocator<U, MR> &other,

)

Copy constructor. Copies the resource pointer.

inline pointer allocate(size_type n)

Allocates objects of type T.

Parameters:

n – number of elements to allocate

Returns:

a pointer to the newly allocated storage.

inline void deallocate(pointer p, size_type n) noexcept

Deallocates objects of type T.

Parameters:

• p – pointer returned by a previous call to allocate

• n – number of elements, passed as an argument to the allocate call that produced p

inline MR *resource() const

Extracts the memory resource used by this allocator.

Returns:

the memory resource used by this allocator.

template<typename U>
struct rebind

The rebind metafunction provides the type of an allocator instantiated with another type.

Template Parameters:

U – the other type to use for instantiation.

Public Types

using other = allocator<U, MR>

The alias other gives the type of the rebound allocator.