Classe allocator_base

Define a classe base e as funções comuns necessárias para criar um alocador definido pelo usuário de um filtro de sincronização.

Sintaxe

template <class Type, class Sync>
class allocator_base

Parâmetros

Tipo
O tipo dos elementos alocados pelo alocador.

Sincronizar
A política de sincronização do alocador, que é Classe sync_none, Classe sync_per_container, Classe sync_per_thread ou Classe sync_shared.

Construtores

Typedefs

Funções de membro

Requisitos

Cabeçalho:<allocators>

Namespace: stdext

allocator_base::_Charalloc

Aloca armazenamento para uma matriz do tipos char.

char *_Charalloc(size_type count);

Parâmetros

count
O número de elementos na matriz a serem alocados.

Valor de retorno

Um ponteiro para o objeto alocado.

Comentários

Essa função membro é usada pelos contêineres quando são compilados com um compilador que não pode compilar a reassociação. Ela implementa _Charalloc para o alocador definido pelo usuário, retornando o resultado de uma chamada para a função allocate do filtro de sincronização.

allocator_base::_Chardealloc

Libera armazenamento para a matriz que contém os elementos do tipo char.

void _Chardealloc(void* ptr, size_type count);

Parâmetros

ptr
Um ponteiro para o primeiro objeto a ser desalocado do armazenamento.

count
O número de objetos a serem desalocados do armazenamento.

Comentários

Essa função membro é usada pelos contêineres quando são compilados com um compilador que não pode compilar a reassociação. Ela implementa _Chardealloc para o alocador definido pelo usuário ao chamar a função deallocate do filtro de sincronização. O ponteiro PTR deve ter sido retornado anteriormente por uma chamada para _Charalloc de um objeto alocador que compara como igual a *this, alocando um objeto de matriz dos mesmos tipo e tamanho. _Chardealloc nunca gera uma exceção.

allocator_base::endereço

Localiza o endereço de um objeto cujo valor é especificado.

pointer address(reference val);

const_pointer address(const_reference val);

Parâmetros

val
O valor const ou não const do objeto cujo endereço está sendo pesquisado.

Valor de retorno

Um ponteiro const ou não const para o objeto localizado, de valor const ou não const, respectivamente.

Comentários

Essa função de membro é implementada para o alocador definido pelo usuário, retornando &val.

allocator_base::alocar

Aloca um bloco de memória grande o suficiente para armazenar pelo menos um número especificado de elementos.

template <class Other>
pointer allocate(size_type _Nx, const Other* _Hint = 0);

pointer allocate(size_type _Nx);

Parâmetros

_Nx
O número de elementos na matriz a serem alocados.

_Hint
Este parâmetro é ignorado.

Valor de retorno

Um ponteiro para o objeto alocado.

Comentários

A função de membro implementa a alocação de memória para o alocador definido pelo usuário, retornando o resultado de uma chamada para a função allocate do filtro de sincronização do tipo Type * se _Nx == 1, caso contrário, retornando o resultado de uma chamada para operator new(_Nx * sizeof(Type)) transmitido para o tipo Type *.

allocator_base::allocator_base

Constrói um objeto do tipo allocator_base.

allocator_base();

template <class Other>
allocator_base(const allocator_base<Other, Sync>& right);

Parâmetros

direita
O objeto alocador a ser copiado.

Comentários

O primeiro construtor constrói uma instância de allocator_base. O segundo construtor constrói uma instância allocator_base de modo que, para qualquer instância de allocator_base<Type, _Sync>a, allocator_base<Type, Sync>(allocator_base<Other, Sync>(a)) == a.

allocator_base::const_pointer

Um tipo que fornece um ponteiro constante para o tipo de objeto gerenciado pelo alocador.

typedef const Type *const_pointer;

allocator_base::const_reference

Um tipo que fornece uma referência constante ao tipo de objeto gerenciado pelo alocador.

typedef const Type& const_reference;

allocator_base::construir

Constrói um tipo específico de objeto em um endereço especificado que é inicializado com um valor especificado.

void construct(pointer ptr, const Type& val);

Parâmetros

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

val
O valor com o qual o objeto que está sendo construído deve ser inicializado.

Comentários

Essa função de membro é implementada para o alocador definido pelo usuário ao chamar new((void*)ptr Type(val).

allocator_base::d eallocate

Libera um número especificado de objetos do armazenamento começando em uma posição especificada.

void deallocate(pointer ptr, size_type _Nx);

Parâmetros

ptr
Um ponteiro para o primeiro objeto a ser desalocado do armazenamento.

_Nx
O número de objetos a serem desalocados do armazenamento.

Comentários

Essa função de membro é implementada para o alocador definido pelo usuário chamando deallocate(ptr) no filtro de sincronização Sync se _Nx == 1, caso contrário, chamando operator delete(_Nx * ptr).

allocator_base::d estroy

Chama um destruidor de objetos sem desalocar a memória na qual o objeto foi armazenado.

void destroy(pointer ptr);

Parâmetros

ptr
Um ponteiro que designa o endereço do objeto a ser destruído.

Comentários

Essa função de membro é implementada para o alocador definido pelo usuário ao chamar ptr->~Type().

allocator_base::d tipo_de_diferenciação

Um tipo integral com sinal que pode representar a diferença entre os valores de ponteiros para o tipo de objeto gerenciado pelo alocador.

typedef std::ptrdiff_t difference_type;

allocator_base::max_size

Retorna o número de elementos do tipo Type que podem ser alocados por um objeto da classe allocator antes que a memória livre seja totalmente usada.

size_type max_size() const;

Valor de retorno

O número de elementos que podem ser alocados.

Comentários

Essa função de membro é implementada para o alocador definido pelo usuário, retornando (size_t)-1 / sizeof(Type) se 0 < (size_t)-1 / sizeof(Type), caso contrário, 1.

allocator_base::p ointer

Um tipo que fornece um ponteiro para o tipo de objeto gerenciado pelo alocador.

typedef Type *pointer;

allocator_base::referência

Um tipo que fornece uma referência ao tipo de objeto gerenciado pelo alocador.

typedef Type& reference;

allocator_base::size_type

Um tipo integral sem sinal que pode representar o comprimento de qualquer sequência que um objeto do tipo allocator_base possa alocar.

typedef std::size_t size_type;

allocator_base::value_type

Um tipo que é gerenciado pelo alocador.

typedef Type value_type;

Confira também

<allocators>