Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes