Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::forward : préserver la catégorie de valeur

std::forward<T> restaure la catégorie enregistrée par la déduction d’une référence de transfert.

Version : C++23

Syntaxe

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> renvoie static_cast<T&&>(t) et est constexpr et noexcept. Un paramètre nommé T&& est lui-même une lvalue. Si l’argument était une lvalue, T est déduit comme U& et le repliement donne U& ; pour une rvalue, T vaut U et le résultat est U&&.

L’exemple relaie vers deux surcharges select. Un int nommé choisit select(int&), un temporaire choisit select(int&&) ; la sortie est lvalue rvalue. Le perfect forwarding conserve aussi les qualifications cv comme const.

std::forward ne déplace pas l’objet et ne prolonge pas sa vie : il caste, puis le destinataire peut déplacer. Il faut employer exactement le T déduit et ne transférer normalement qu’une fois une valeur consommable. Un type explicite erroné peut transformer une lvalue en rvalue. La seconde surcharge impose que T ne soit pas une référence lvalue.

Exemples

#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);
}

Résultat

lvalue rvalue

std::forward → lvalue rvalue

Sources