std::unique_ptr<T,Deleter>::operator<< (3) - Linux Man Pages

std::unique_ptr<T,Deleter>::operator<<: std::unique_ptr<T,Deleter>::operator<<

NAME

std::unique_ptr<T,Deleter>::operator<< - std::unique_ptr<T,Deleter>::operator<<

Synopsis


template <class CharT, class Traits, class Y, class D>
std::basic_ostream<CharT, Traits>& operator<<(std::basic_ostream<CharT, Traits>& os, (since C++20)
const std::unique_ptr<Y, D>& p);


Inserts the value of the pointer managed by p into the output stream os.
Equivalent to os << p.get().
This overload only participates in overload resolution if os << p.get() is a valid expression.

Parameters


os - a std::basic_ostream to insert p into
p - the pointer to be inserted into os

Return value


os

Notes


If std::unique_ptr<Y, D>::pointer is a pointer to a character type (e.g., when Y is char or char[] or CharT), this may end up calling the overloads_of_operator<<_for_null-terminated_character_strings (causing undefined behavior if the pointer does not in fact point to such a string), rather than the_overload_for_printing_the_value_of_the_pointer_itself.

Example


// Run this code


  #include <iostream>
  #include <memory>


  class Foo {};


  int main()
  {
      auto p = std::make_unique<Foo>();
      std::cout << p << '\n';
      std::cout << p.get() << '\n';
  }

Possible output:


  0x6d9028
  0x6d9028

See also


    returns a pointer to the managed object
get (public member function)