Namespaces
Variants

    std::ref, std::cref

    Von de.cppreference.net
     
    C++
     
    Hilfsmittelbibliothek (Utilities library)
    Sprachunterstützung
    Typunterstützung (Basistypen, RTTI)
    Bibliotheks-Feature-Test-Makros (C++20)
    Programm-Hilfsmittel
    Funktionen mit variabler Argumentanzahl
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Koroutinen-Unterstützung (C++20)
    Vertragsunterstützung (C++26)
    Drei-Wege-Vergleich
    (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)

    Allgemeine Hilfsmittel
    Relationale Operatoren (veraltet in C++20)
    Ganzzahl-Vergleichsfunktionen
    (C++20)(C++20)(C++20)    
    (C++20)
    Tausch- und Typoperationen
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    Gebräuchliche Vokabular-Typen
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    Funktionsobjekte
    Funktionsaufruf
    (C++17)(C++23)
    Identitäts-Funktionsobjekt
    (C++20)
    Transparente Operator-Wrapper
    (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)

    Alte Binder und Adapter
    (bis C++17*)
    (bis C++17*)
    (bis C++17*)
    (bis C++17*)
    (bis C++17*)  
    (bis C++17*)
    (bis C++17*)(bis C++17*)(bis C++17*)(bis C++17*)
    (bis C++20*)
    (bis C++20*)
    (bis C++17*)(bis C++17*)
    (bis C++17*)(bis C++17*)

    (bis C++17*)
    (bis C++17*)(bis C++17*)(bis C++17*)(bis C++17*)
    (bis C++20*)
    (bis C++20*)
     
    Definiert in Header <functional> 
    template< class T >
std::reference_wrapper<T> ref( T& t ) noexcept;
    		(1) (seit C++11)
    (constexpr seit C++20)    		 
    template< class T >
std::reference_wrapper<T>
    ref( std::reference_wrapper<T> t ) noexcept;
    		(2) (seit C++11)
    (constexpr seit C++20)    		 
    template< class T >
void ref( const T&& ) = delete;
    		(3) (seit C++11) 
    template< class T >
std::reference_wrapper<const T> cref( const T& t ) noexcept;
    		(4) (seit C++11)
    (constexpr seit C++20)    		 
    template< class T >
std::reference_wrapper<const T>
    cref( std::reference_wrapper<T> t ) noexcept;
    		(5) (seit C++11)
    (constexpr seit C++20)    		 
    template< class T >
void cref( const T&& ) = delete;
    		(6) (seit C++11)

    Die Funktionsschablonen ref und cref sind Hilfsfunktionen, die ein Objekt des Typs std::reference_wrapper erzeugen, wobei Template-Argument-Deduktion verwendet wird, um das Template-Argument des Ergebnisses zu bestimmen.

    T kann ein unvollständiger Typ sein.

    		(seit C++20)

    Parameter

    t - lvalue-Referenz auf das zu umschließende Objekt oder eine Instanz von std::reference_wrapper

    Rückgabewert

    1) std:: reference_wrapper < T > ( t )
    2) t
    4) std:: reference_wrapper < const T > ( t )
    5) t
    3,6) Rvalue-Referenz-Wrapper ist gelöscht.

    Beispiel

    Diesen Code ausführen 
    #include <functional>
#include <iostream>
void f(int& n1, int& n2, const int& n3)
{
    std::cout << "In function: " << n1 << ' ' << n2 << ' ' << n3 << '\n';
    ++n1; // increments the copy of n1 stored in the function object
    ++n2; // increments the main()'s n2
    // ++n3; // compile error
}
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';
}

    Ausgabe: 

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

    Fehlerberichte

    Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

    DR Angewendet auf Verhalten wie veröffentlicht Korrektes Verhalten
    LWG 3146 C++11 Unwrapping-Überladungen führten manchmal zu Fehlern immer gültig gemacht

    Siehe auch

    (C++11)
    		CopyConstructible und CopyAssignable Referenz-Wrapper
    (Klassen-Template)