Namespaces
Variants

    std::ref, std::cref

    Depuis fr.cppreference.net
     
    C++
    Support du compilateur
    Libre et hébergé
    Langage
    Bibliothèque standard
    En‑têtes de la bibliothèque standard
    Exigences nommées
    Macros de test de fonctionnalités (C++20)
    Bibliothèque de support du langage
    Bibliothèque de concepts (C++20)
    Bibliothèque de diagnostics
    Bibliothèque de gestion de la mémoire
    Bibliothèque de métaprogrammation (C++11)
    Bibliothèque d’utilitaires généraux
    Bibliothèque de conteneurs
    Bibliothèque d’itérateurs
    Bibliothèque des intervalles (C++20)
    Bibliothèque d’algorithmes
    Bibliothèque de chaînes
    Bibliothèque de traitement de texte
    Bibliothèque numérique
    Bibliothèque de date et d’heure
    Bibliothèque d’entrée/sortie
    Bibliothèque du système de fichiers (C++17)
    Bibliothèque de support de la concurrence (C++11)
    Bibliothèque de contrôle d’exécution (C++26)
    Spécifications techniques
    Index des symboles
    Bibliothèques externes
     
    Bibliothèque d’utilitaires
    Support du langage
    Support des types (types de base, RTTI)
    Macros de test de fonctionnalités de la bibliothèque (C++20)
    Utilitaires de programme
    Fonctions variadiques
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Support des coroutines (C++20)
    Support des contrats (C++26)
    Comparaison à trois voies
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    Utilitaires généraux
    Opérateurs relationnels (obsolète en C++20)
     
    Objets fonction
    Invocation de fonction
    (C++17)(C++23)
    Objet fonction identité
    (C++20)
    Encapsuleurs d’opérateurs transparents
    (C++14)
    (C++14)
    (C++14)
    (C++14)  
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)

    Anciens binders et adaptateurs
    (jusqu'à C++17*)
    (jusqu'à C++17*)
    (jusqu'à C++17*)
    (jusqu'à C++17*)
    (jusqu'à C++17*)  
    (jusqu'à C++17*)
    (jusqu'à C++17*)(jusqu'à C++17*)(jusqu'à C++17*)(jusqu'à C++17*)
    (jusqu'à C++20*)
    (jusqu'à C++20*)
    (jusqu'à C++17*)(jusqu'à C++17*)
    (jusqu'à C++17*)(jusqu'à C++17*)

    (jusqu'à C++17*)
    (jusqu'à C++17*)(jusqu'à C++17*)(jusqu'à C++17*)(jusqu'à C++17*)
    (jusqu'à C++20*)
    (jusqu'à C++20*)
     
    Défini dans l'en‑tête <functional> 
    template< class T >
std::reference_wrapper<T> ref( T& t ) noexcept;
    		(1) (depuis C++11)
    (constexpr depuis C++20)    		 
    template< class T >
std::reference_wrapper<T>
    ref( std::reference_wrapper<T> t ) noexcept;
    		(2) (depuis C++11)
    (constexpr depuis C++20)    		 
    template< class T >
void ref( const T&& ) = delete;
    		(3) (depuis C++11) 
    template< class T >
std::reference_wrapper<const T> cref( const T& t ) noexcept;
    		(4) (depuis C++11)
    (constexpr depuis C++20)    		 
    template< class T >
std::reference_wrapper<const T>
    cref( std::reference_wrapper<T> t ) noexcept;
    		(5) (depuis C++11)
    (constexpr depuis C++20)    		 
    template< class T >
void cref( const T&& ) = delete;
    		(6) (depuis C++11)

    Les modèles de fonction ref et cref sont des fonctions auxiliaires qui génèrent un objet de type std::reference_wrapper, en utilisant la déduction d'argument de modèle pour déterminer l'argument modèle du résultat.

    T peut être un type incomplet.

    		(depuis C++20)

    Paramètres

    t - référence lvalue vers l'objet à encapsuler ou une instance de std::reference_wrapper

    Valeur de retour

    1) std:: reference_wrapper < T > ( t )
    2) t
    4) std:: reference_wrapper < const T > ( t )
    5) t
    3,6) Le wrapper de référence rvalue est supprimé.

    Exemple

    Exécuter ce code 
    #include <functional>
#include <iostream>
void f(int& n1, int& n2, const int& n3)
{
    std::cout << "In function: " << n1 << ' ' << n2 << ' ' << n3 << '\n';
    ++n1; // incrémente la copie de n1 stockée dans l'objet fonction
    ++n2; // incrémente le n2 de main()
    // ++n3; // erreur de compilation
}
int main()
{
    int n1 = 1, n2 = 2, n3 = 3;
    std::function<void()> bound_f = std::bind(f, n1, std::ref(n2), std::cref(n3));
    n1 = 10;
    n2 = 11;
    n3 = 12;
    std::cout << "Before function: " << n1 << ' ' << n2 << ' ' << n3 << '\n';
    bound_f();
    std::cout << "After function: " << n1 << ' ' << n2 << ' ' << n3 << '\n';
}

    Sortie : 

    Before function: 10 11 12
In function: 1 11 12
After function: 10 12 12

    Rapports de défauts

    Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

    DR Appliqué à Comportement tel que publié Comportement correct
    LWG 3146 C++11 les surcharges de déballage menaient parfois à une erreur rendu toujours valide

    Voir aussi

    (C++11)
    		CopyConstructible et CopyAssignable wrapper de référence
    (modèle de classe)