Compartilhar via


Classe allocator_traits

O modelo de classe descreve um objeto que complementa um tipo de alocador. Um tipo de alocador é qualquer tipo que descreve um objeto alocador que é usado para gerenciar o armazenamento alocado. Especificamente, para qualquer tipo de alocador Alloc, você pode usar allocator_traits<Alloc> para determinar todas as informações necessárias para um contêiner habilitado para alocador. Para obter mais informações, consulte a Classe allocator padrão.

Sintaxe

template <class Alloc>
    class allocator_traits;

Membros

Typedefs

Nome Descrição
allocator_type Esse tipo é um sinônimo do parâmetro de modelo Alloc.
const_pointer Esse tipo será Alloc::const_pointer, se aquele tipo for bem formado, caso contrário, será pointer_traits<pointer>::rebind<const value_type>.
const_void_pointer Esse tipo será Alloc::const_void_pointer, se aquele tipo for bem formado, caso contrário, será pointer_traits<pointer>::rebind<const void>.
difference_type Esse tipo será Alloc::difference_type, se aquele tipo for bem formado, caso contrário, será pointer_traits<pointer>::difference_type.
pointer Esse tipo será Alloc::pointer, se aquele tipo for bem formado, caso contrário, será value_type *.
propagate_on_container_copy_assignment Esse tipo será Alloc::propagate_on_container_copy_assignment, se aquele tipo for bem formado, caso contrário, será false_type.
propagate_on_container_move_assignment Esse tipo será Alloc::propagate_on_container_move_assignment, se aquele tipo for bem formado, caso contrário, será false_type. Se o tipo for verdadeiro, um contêiner habilitado para alocador copiará seu alocador armazenado em uma atribuição de movimentação.
propagate_on_container_swap Esse tipo será Alloc::propagate_on_container_swap, se aquele tipo for bem formado, caso contrário, será false_type. Se o tipo for verdadeiro, um contêiner habilitado para alocador trocará seu alocador armazenado em uma troca.
size_type Esse tipo será Alloc::size_type, se aquele tipo for bem formado, caso contrário, será make_unsigned<difference_type>::type.
value_type Esse tipo é um sinônimo de Alloc::value_type.
void_pointer Esse tipo será Alloc::void_pointer, se aquele tipo for bem formado, caso contrário, será pointer_traits<pointer>::rebind<void>.

Métodos estáticos

Os seguintes métodos estáticos chamam o método correspondente em um parâmetro alocador determinado.

Nome Descrição
allocate Método estático que aloca memória usando o parâmetro alocador determinado.
construct Método estático que usa um alocador especificado para construir um objeto.
deallocate Método estático que usa um alocador especificado para desalocar um número especificado de objetos.
destroy Método estático que usa um alocador especificado para chamar o destruidor em um objeto sem desalocar sua memória.
max_size Método estático que usa um alocador especificado para determinar o número máximo de objetos que podem ser alocados.
select_on_container_copy_construction Método estático que chama select_on_container_copy_construction no alocador especificado.

allocate

Método estático que aloca memória usando o parâmetro alocador determinado.

static pointer allocate(Alloc& al, size_type count);

static pointer allocate(Alloc& al, size_type count,
    typename allocator_traits<void>::const_pointer* hint);

Parâmetros

al
Um objeto alocador.

count
O número de elementos a serem alocados.

hint
Um const_pointer que pode ajudar o objeto alocador a atender à solicitação de armazenamento, localizando o endereço de um objeto alocado antes da solicitação. Um ponteiro nulo é tratado como nenhuma dica.

Valor de retorno

Cada método retorna um ponteiro para o objeto alocado.

O primeiro método estático retorna al.allocate(count).

O segundo método retornará al.allocate(count, hint), se essa expressão for bem formada, caso contrário, retornará al.allocate(count).

constructo

Método estático que usa um alocador especificado para construir um objeto.

template <class Uty, class Types>
static void construct(Alloc& al, Uty* ptr, Types&&... args);

Parâmetros

al
Um objeto alocador.

ptr
Um ponteiro para o local no qual o objeto deve ser construído.

args
Uma lista de argumentos que é passada ao construtor de objetos.

Comentários

A função de membro estática chamará al.construct(ptr, args...), se essa expressão for bem formada, caso contrário, será avaliada como ::new (static_cast<void *>(ptr)) Uty(std::forward<Types>(args)...).

deallocate

Método estático que usa um alocador especificado para desalocar um número especificado de objetos.

static void deallocate(Alloc al,
    pointer ptr,
    size_type count);

Parâmetros

al
Um objeto alocador.

ptr
Um ponteiro para o local inicial dos objetos a serem desalocados.

count
O número de objetos a serem desalocados.

Comentários

Esse método chama al.deallocate(ptr, count).

Esse método não gera nada.

destroy

Método estático que usa um alocador especificado para chamar o destruidor em um objeto sem desalocar sua memória.

template <class Uty>
    static void destroy(Alloc& al, Uty* ptr);

Parâmetros

al
Um objeto alocador.

ptr
Um ponteiro para o local do objeto.

Comentários

Esse método chamará al.destroy(ptr), se essa expressão for bem formada, caso contrário, será avaliado como ptr->~Uty().

max_size

Método estático que usa um alocador especificado para determinar o número máximo de objetos que podem ser alocados.

static size_type max_size(const Alloc& al);

Parâmetros

al
Um objeto alocador.

Comentários

Esse método retornará al.max_size(), se essa expressão for bem formada, caso contrário, retornará numeric_limits<size_type>::max().

select_on_container_copy_construction

Método estático que chama select_on_container_copy_construction no alocador especificado.

static Alloc select_on_container_copy_construction(const Alloc& al);

Parâmetros

al
Um objeto alocador.

Valor de retorno

Este método retorna al.select_on_container_copy_construction(), se aquele tipo for bem formado. Caso contrário, retornará al.

Comentários

Esse método é usado para especificar um alocador quando o contêiner associado é construído por cópia.