CKTIS / C++
std::reference_wrapper — um wrapper de referência copiável
std::reference_wrapper armazena uma referência sem ser proprietário do objeto referenciado. Aprende sobre std::ref, std::cref e a diferença entre modificar o objeto referenciado e mudar o objeto a que o wrapper se refere.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <functional>
std::reference_wrapper<T> wrapper = std::ref(object);
std::reference_wrapper<const T> readonly = std::cref(object);
wrapper.get();std::reference_wrapper<T> de <functional> é um objeto copiável e atribuível que envolve uma referência a um objeto ou função. Uma cópia continua a referir-se ao mesmo destino; não o copia. É útil quando é necessário representar uma referência como um valor normal, por exemplo, num contentor. Se o objeto envolvido puder ser chamado, operator() encaminha a chamada para o destino.
std::ref(x) cria um std::reference_wrapper<T>, preservando os qualificadores de tipo de x; não remove const. std::cref(x) cria um std::reference_wrapper<const T>, que dá acesso a um objeto através de uma referência a um tipo qualificado com const. Um membro de dados declarado mutable pode, ainda assim, ser modificado diretamente através da referência devolvida por get(). As sobrecargas que aceitam um wrapper existente preservam o respetivo destino, em vez de criarem um wrapper aninhado.
get() devolve T&; também está disponível uma conversão implícita para T&. Um const std::reference_wrapper<T> não acrescenta, por si só, const ao tipo referenciado. Para aceder ao objeto através de uma referência a const T, utiliza std::reference_wrapper<const T>. A atribuição r = std::ref(b) altera o destino do wrapper, enquanto r.get() = b atribui um valor ao destino atual.
O wrapper não gere nem prolonga o tempo de vida do destino. O destino tem de existir sempre que a referência é utilizada; caso contrário, a referência fica pendente. As sobrecargas eliminadas de std::ref e std::cref impedem que se usem objetos temporários comuns como destino. Já as sobrecargas que recebem um std::reference_wrapper aceitam wrappers temporários. Se a for um objeto existente do tipo int, tanto std::ref(std::ref(a)) como std::cref(std::ref(a)) são expressões válidas e referem-se a a. O wrapper não tem construtor predefinido nem estado vazio.
Esta entrada diz respeito a C++23. A fonte eel.is é um rascunho em evolução e pode conter adições posteriores; esta entrada não pressupõe que estejam disponíveis.
Exemplos
#include <functional>
#include <iostream>
int main() {
int a = 10;
int b = 20;
auto r = std::ref(a);
auto copy = r;
const auto readonly = std::cref(a);
copy.get() += 5;
r = std::ref(b);
r.get() += 2;
std::cout << a << ' ' << b << ' ' << readonly.get() << '\n';
}
Resultado
15 22 15
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.