Boost C++ Libraries of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.

Class template reference_wrapper

boost::reference_wrapper — Contains a reference to an object of type T.


// In header: <boost/core/ref.hpp>

template<typename T> 
class reference_wrapper {
  // types
  typedef T type;

  // construct/copy/destruct
  explicit reference_wrapper(T &);
  reference_wrapper(T &&) = delete;
  template<typename Y> 
    reference_wrapper(reference_wrapper< Y >, unspecified = unspecified);

  // public member functions
  operator T &() const;
  T & get() const;
  T * get_pointer() const;


reference_wrapper is primarily used to "feed" references to function templates (algorithms) that take their parameter by value. It provides an implicit conversion to T&, which usually allows the function templates to work on references unmodified.

reference_wrapper public types

  1. typedef T type;

    Type T.

reference_wrapper public construct/copy/destruct

  1. explicit reference_wrapper(T & t);

    Constructs a reference_wrapper object that stores a reference to t.

    Does not throw.

  2. reference_wrapper(T && t) = delete;

    Construction from a temporary object is disabled.

  3. template<typename Y> 
      reference_wrapper(reference_wrapper< Y > r, unspecified = unspecified);

    Constructs a reference_wrapper object that stores the reference stored in the compatible reference_wrapper r.

    Only enabled when Y* is convertible to T*.

    Does not throw.

reference_wrapper public member functions

  1. operator T &() const;

    Does not throw.


    The stored reference.

  2. T & get() const;

    Does not throw.


    The stored reference.

  3. T * get_pointer() const;

    Does not throw.


    A pointer to the object referenced by the stored reference.