libstdc++
std::allocator_traits< allocator< _Tp > > Struct Template Reference

Public Types

using allocator_type = allocator< _Tp >
 
using const_pointer = const _Tp *
 
using const_void_pointer = const void *
 
using difference_type = std::ptrdiff_t
 
using is_always_equal = true_type
 
using pointer = _Tp *
 
using propagate_on_container_copy_assignment = false_type
 
using propagate_on_container_move_assignment = true_type
 
using propagate_on_container_swap = false_type
 
template<typename _Up >
using rebind_alloc = allocator< _Up >
 
template<typename _Up >
using rebind_traits = allocator_traits< allocator< _Up > >
 
using size_type = std::size_t
 
using value_type = _Tp
 
using void_pointer = void *
 

Static Public Member Functions

static _GLIBCXX_NODISCARD pointer allocate (allocator_type &__a, size_type __n)
 
static _GLIBCXX_NODISCARD pointer allocate (allocator_type &__a, size_type __n, const_void_pointer __hint)
 
template<typename _Up , typename... _Args>
static void construct (allocator_type &__a, _Up *__p, _Args &&... __args) noexcept(noexcept(__a.construct(__p, std::forward< _Args >(__args)...)))
 
static void deallocate (allocator_type &__a, pointer __p, size_type __n)
 
template<typename _Up >
static void destroy (allocator_type &__a, _Up *__p) noexcept(noexcept(__a.destroy(__p)))
 
static size_type max_size (const allocator_type &__a) noexcept
 
static allocator_type select_on_container_copy_construction (const allocator_type &__rhs)
 

Detailed Description

template<typename _Tp>
struct std::allocator_traits< allocator< _Tp > >

Partial specialization for std::allocator.

Definition at line 392 of file bits/alloc_traits.h.

Member Typedef Documentation

◆ allocator_type

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::allocator_type = allocator<_Tp>

The allocator type.

Definition at line 395 of file bits/alloc_traits.h.

◆ const_pointer

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::const_pointer = const _Tp*

The allocator's const pointer type.

Definition at line 403 of file bits/alloc_traits.h.

◆ const_void_pointer

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::const_void_pointer = const void*

The allocator's const void pointer type.

Definition at line 409 of file bits/alloc_traits.h.

◆ difference_type

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::difference_type = std::ptrdiff_t

The allocator's difference type.

Definition at line 412 of file bits/alloc_traits.h.

◆ is_always_equal

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::is_always_equal = true_type

Whether all instances of the allocator type compare equal.

Definition at line 427 of file bits/alloc_traits.h.

◆ pointer

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::pointer = _Tp*

The allocator's pointer type.

Definition at line 400 of file bits/alloc_traits.h.

◆ propagate_on_container_copy_assignment

How the allocator is propagated on copy assignment.

Definition at line 418 of file bits/alloc_traits.h.

◆ propagate_on_container_move_assignment

How the allocator is propagated on move assignment.

Definition at line 421 of file bits/alloc_traits.h.

◆ propagate_on_container_swap

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::propagate_on_container_swap = false_type

How the allocator is propagated on swap.

Definition at line 424 of file bits/alloc_traits.h.

◆ size_type

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::size_type = std::size_t

The allocator's size type.

Definition at line 415 of file bits/alloc_traits.h.

◆ value_type

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::value_type = _Tp

The allocated type.

Definition at line 397 of file bits/alloc_traits.h.

◆ void_pointer

template<typename _Tp >
using std::allocator_traits< allocator< _Tp > >::void_pointer = void*

The allocator's void pointer type.

Definition at line 406 of file bits/alloc_traits.h.

Member Function Documentation

◆ allocate() [1/2]

template<typename _Tp >
static _GLIBCXX_NODISCARD pointer std::allocator_traits< allocator< _Tp > >::allocate ( allocator_type __a,
size_type  __n 
)
inlinestatic

Allocate memory.

Parameters
__aAn allocator.
__nThe number of objects to allocate space for.

Calls a.allocate(n)

Definition at line 443 of file bits/alloc_traits.h.

◆ allocate() [2/2]

template<typename _Tp >
static _GLIBCXX_NODISCARD pointer std::allocator_traits< allocator< _Tp > >::allocate ( allocator_type __a,
size_type  __n,
const_void_pointer  __hint 
)
inlinestatic

Allocate memory.

Parameters
__aAn allocator.
__nThe number of objects to allocate space for.
__hintAid to locality.
Returns
Memory of suitable size and alignment for n objects of type value_type

Returns a.allocate(n, hint)

Definition at line 457 of file bits/alloc_traits.h.

◆ construct()

template<typename _Tp >
template<typename _Up , typename... _Args>
static void std::allocator_traits< allocator< _Tp > >::construct ( allocator_type __a,
_Up *  __p,
_Args &&...  __args 
)
inlinestaticnoexcept

Construct an object of type _Up.

Parameters
__aAn allocator.
__pPointer to memory of suitable size and alignment for Tp
__argsConstructor arguments.

Calls __a.construct(__p, std::forward<Args>(__args)...)

Definition at line 482 of file bits/alloc_traits.h.

◆ deallocate()

template<typename _Tp >
static void std::allocator_traits< allocator< _Tp > >::deallocate ( allocator_type __a,
pointer  __p,
size_type  __n 
)
inlinestatic

Deallocate memory.

Parameters
__aAn allocator.
__pPointer to the memory to deallocate.
__nThe number of objects space was allocated for.

Calls a.deallocate(p, n)

Definition at line 469 of file bits/alloc_traits.h.

◆ destroy()

template<typename _Tp >
template<typename _Up >
static void std::allocator_traits< allocator< _Tp > >::destroy ( allocator_type __a,
_Up *  __p 
)
inlinestaticnoexcept

Destroy an object of type _Up.

Parameters
__aAn allocator.
__pPointer to the object to destroy

Calls __a.destroy(__p).

Definition at line 495 of file bits/alloc_traits.h.

◆ max_size()

template<typename _Tp >
static size_type std::allocator_traits< allocator< _Tp > >::max_size ( const allocator_type __a)
inlinestaticnoexcept

The maximum supported allocation size.

Parameters
__aAn allocator.
Returns
__a.max_size()

Definition at line 505 of file bits/alloc_traits.h.

◆ select_on_container_copy_construction()

template<typename _Tp >
static allocator_type std::allocator_traits< allocator< _Tp > >::select_on_container_copy_construction ( const allocator_type __rhs)
inlinestatic

Obtain an allocator to use when copying a container.

Parameters
__rhsAn allocator.
Returns
__rhs

Definition at line 514 of file bits/alloc_traits.h.


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