Namespaces
Variants

std::ref, std::cref

De es.cppreference.net
 
 
Biblioteca de utilidades
Soporte del lenguaje
Soporte de tipos (tipos básicos, RTTI)
Macros de prueba de características de la biblioteca (C++20)
Utilidades del programa
Funciones variádicas
Soporte de corrutinas (C++20)
Soporte de contratos (C++26)
Comparación de tres vías
(C++20)
(C++20)(C++20)(C++20)    
(C++20)(C++20)(C++20)

Utilidades generales
Operadores relacionales (obsoleto en C++20)
 
Objetos función
Invocación de funciones
(C++17)(C++23)
Objeto función identidad
(C++20)
Envoltorios de operadores transparentes
(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)

Antiguos vinculadores y adaptadores
(hasta C++17*)
(hasta C++17*)
(hasta C++17*)
(hasta C++17*)  
(hasta C++17*)
(hasta C++17*)(hasta C++17*)(hasta C++17*)(hasta C++17*)
(hasta C++20*)
(hasta C++20*)
(hasta C++17*)(hasta C++17*)
(hasta C++17*)(hasta C++17*)

(hasta C++17*)
(hasta C++17*)(hasta C++17*)(hasta C++17*)(hasta C++17*)
(hasta C++20*)
(hasta C++20*)
 
Definido en el encabezado <functional>
template< class T >
std::reference_wrapper<T> ref( T& t ) noexcept;
(1) (desde C++11)
(constexpr desde C++20)
template< class T >
std::reference_wrapper<T>
    ref( std::reference_wrapper<T> t ) noexcept;
(2) (desde C++11)
(constexpr desde C++20)
template< class T >
void ref( const T&& ) = delete;
(3) (desde C++11)
template< class T >
std::reference_wrapper<const T> cref( const T& t ) noexcept;
(4) (desde C++11)
(constexpr desde C++20)
template< class T >
std::reference_wrapper<const T>
    cref( std::reference_wrapper<T> t ) noexcept;
(5) (desde C++11)
(constexpr desde C++20)
template< class T >
void cref( const T&& ) = delete;
(6) (desde C++11)

Las plantillas de función ref y cref son funciones auxiliares que generan un objeto de tipo std::reference_wrapper, usando deducción de argumentos de plantilla para determinar el argumento de plantilla del resultado.

T puede ser un tipo incompleto.

(desde C++20)

Parámetros

t - referencia lvalue al objeto que necesita ser envuelto o una instancia de std::reference_wrapper

Valor de retorno

2) t
4) std:: reference_wrapper < const T > ( t )
5) t
3,6) El contenedor de referencia rvalue está eliminado.

Ejemplo

#include <functional>
#include <iostream>
void f(int& n1, int& n2, const int& n3)
{
    std::cout << "In function: " << n1 << ' ' << n2 << ' ' << n3 << '\n';
    ++n1; // incrementa la copia de n1 almacenada en el objeto función
    ++n2; // incrementa el n2 de main()
    // ++n3; // error de compilación
}
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';
}

Salida:

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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

DR Aplicado a Comportamiento publicado Comportamiento correcto
LWG 3146 C++11 las sobrecargas de desempaquetado a veces causaban error se hizo siempre válido

Véase también

CopyConstructible y CopyAssignable envoltorio de referencia
(plantilla de clase)