CKTIS / C++
std::launder — um ponteiro após reutilizar o armazenamento
std::launder de <new> obtém um ponteiro para um objeto num dado endereço quando um ponteiro antigo não aponta automaticamente para o seu substituto. Não cria objetos nem corrige acessos inválidos à memória.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <new>
// Inside a function, given a T* p that meets std::launder's preconditions:
T* current = std::launder(p);std::launder(p) devolve um ponteiro do tipo T* para um objeto no endereço representado por p. É útil após a reutilização do armazenamento quando as regras de duração de vida impedem usar o ponteiro antigo como ponteiro para o novo objeto. Está declarada em <new>; não aloca armazenamento nem inicia a duração de vida de um objeto.
T não pode ser um tipo função nem void. Nesse endereço tem de existir um objeto cujo tipo seja semelhante a T segundo as regras de qualificação. No caso normal, já tem de estar dentro da sua duração de vida. Todos os bytes acessíveis através do resultado também têm de ser acessíveis através de p: a função não alarga o intervalo de acesso permitido. Não corrige um alinhamento incorreto, um tipo incompatível nem o acesso a armazenamento desalocado.
Na substituição transparente, os ponteiros antigos apontam automaticamente para o novo objeto, pelo que std::launder é desnecessária. O exemplo substitui deliberadamente um objeto completo const Item em armazenamento dinâmico, ao qual essa regra não se aplica. Não reutilize de forma análoga o armazenamento de um objeto completo const com duração de armazenamento automática, estática ou de thread.
No exemplo, placement new cria o substituto, e std::launder(old) fornece o ponteiro usado para a leitura e para delete. Avaliar diretamente old->value após a substituição teria comportamento indefinido. Em alternativa, pode conservar o ponteiro devolvido diretamente por placement new, em vez de chamar std::launder. A expressão «barreira de otimização de ponteiros» não significa uma barreira de sincronização entre threads.
Exemplos
#include <iostream>
#include <new>
struct Item {
int value;
};
int main() {
const Item* old = new const Item{3};
::new (static_cast<void*>(const_cast<Item*>(old))) const Item{5};
const Item* current = std::launder(old);
std::cout << current->value << '\n';
delete current;
}
Resultado
5
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.