CKTIS / C++
std::pmr::memory_resource — recurso de memória polimórfico
std::pmr::memory_resource é uma interface abstrata para alocar e desalocar armazenamento com um alinhamento especificado. Permite escolher uma estratégia de alocação em tempo de execução, enquanto std::pmr::polymorphic_allocator liga essa interface ao código que espera um alocador.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <memory_resource>
std::pmr::memory_resource* resource = std::pmr::new_delete_resource();
void* p = resource->allocate(bytes, alignment);
resource->deallocate(p, bytes, alignment);std::pmr::memory_resource, declarado em <memory_resource>, representa um recurso de armazenamento, não um alocador tipado nem um contentor. Não pode ser instanciado diretamente. std::pmr::polymorphic_allocator<T> utiliza um recurso escolhido em tempo de execução sem alterar o seu tipo estático; guarda um ponteiro para o recurso sem assumir a sua propriedade. O recurso tem de permanecer disponível durante as operações que o utilizam.
allocate(bytes, alignment) aloca pelo menos bytes bytes com o alinhamento pedido; alignment tem de ser uma potência de dois e, por predefinição, é alignof(std::max_align_t). Não se trata de uma operação genérica para invocar os construtores de objetos definidos pelo utilizador. Uma falha de alocação é comunicada através de uma exceção. deallocate(p, bytes, alignment) exige o mesmo tamanho e alinhamento, bem como um bloco que ainda não tenha sido desalocado e que tenha sido alocado através de um recurso equivalente. Não invoca os destruidores dos objetos e não pode lançar exceções.
As funções públicas delegam nas funções virtuais puras privadas do_allocate, do_deallocate e do_is_equal, implementadas por uma classe derivada. A interface tem um destruidor virtual. is_equal(other) significa que ambos os recursos podem desalocar as alocações um do outro, e não que tenham configurações idênticas. operator== verifica &a == &b || a.is_equal(b).
O exemplo utiliza new_delete_resource(), um recurso com duração estática baseado em ::operator new e ::operator delete. Aloca e desaloca um bloco sem escrever nele e, em seguida, imprime true, porque chamadas repetidas a essa função devolvem o mesmo recurso. Esta entrada tem como alvo C++23; o projeto de norma fornecido é um documento em evolução, não uma edição C++23 fixa. A opção do compilador do repositório não comprova a compatibilidade do ambiente de execução de produção.
Exemplos
#include <iostream>
#include <memory_resource>
int main() {
std::pmr::memory_resource* resource =
std::pmr::new_delete_resource();
void* p = resource->allocate(sizeof(int), alignof(int));
const bool equal = resource->is_equal(*std::pmr::new_delete_resource());
resource->deallocate(p, sizeof(int), alignof(int));
std::cout << std::boolalpha << equal << '\n';
}
Resultado
true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.