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

CKTIS / C++

std::forward: preservar a categoria de valor

std::forward<T> restaura a categoria registada pela dedução de uma referência de encaminhamento.

Versão: C++23

Sintaxe

template<class T>
constexpr T&& std::forward(std::remove_reference_t<T>& t) noexcept;

template<class T>
constexpr T&& std::forward(std::remove_reference_t<T>&& t) noexcept;

std::forward<T>(t) de <utility> devolve static_cast<T&&>(t) e é constexpr e noexcept. Um parâmetro nomeado T&& é uma expressão lvalue. Se o argumento era lvalue, T é deduzido como U& e o colapso produz U&; para rvalue, T é U e o resultado U&&.

O exemplo encaminha para duas sobrecargas select. Um int nomeado escolhe select(int&), um temporário escolhe select(int&&), imprimindo lvalue rvalue. O perfect forwarding também preserva qualificações cv como const.

std::forward não move o objeto nem prolonga a vida; faz um cast, após o qual o destinatário pode mover. Usa-se o T deduzido exato e normalmente encaminha-se uma vez um valor consumível. Um tipo explícito errado pode transformar lvalue em rvalue. A segunda sobrecarga exige que T não seja uma referência lvalue.

Exemplos

#include <iostream>
#include <utility>

void select(int&) { std::cout << "lvalue "; }
void select(int&&) { std::cout << "rvalue\n"; }

template<class T>
void relay(T&& value) {
    select(std::forward<T>(value));
}

int main() {
    int value = 1;
    relay(value);
    relay(2);
}

Resultado

lvalue rvalue

std::forward → lvalue rvalue

Fontes