Provided by: libstdc++-15-doc_15.2.0-10ubuntu1_all bug

NAME

       std::unique_ptr< _Tp, _Dp > - A move-only smart pointer that manages unique ownership of a resource.

SYNOPSIS

       #include <memory>

   Public Types
       using deleter_type
       using element_type
       using pointer

   Public Member Functions
       template<typename _Del = _Dp, typename = _DeleterConstraint<_Del>> constexpr unique_ptr () noexcept
           Default constructor, creates a unique_ptr that owns nothing.
       template<typename _Up, typename = _Require<is_convertible<_Up*, pointer>,                    is_same<_Dp,
           default_delete<_Tp>>>> unique_ptr (auto_ptr< _Up > &&__u) noexcept
           Converting constructor from auto_ptr.
       unique_ptr (const unique_ptr &)=delete
       template<typename _Del = _Dp, typename = _DeleterConstraint<_Del>> constexpr unique_ptr (nullptr_t)
           noexcept
           Creates a unique_ptr that owns nothing.
       template<typename _Del = _Dp, typename = _DeleterConstraint<_Del>> constexpr unique_ptr (pointer __p)
           noexcept
       template<typename _Del = deleter_type, typename = _Require<is_move_constructible<_Del>>> constexpr
           unique_ptr (pointer __p, __enable_if_t<!is_lvalue_reference< _Del >::value, _Del && > __d) noexcept
       template<typename _Del = deleter_type, typename = _Require<is_copy_constructible<_Del>>> constexpr
           unique_ptr (pointer __p, const deleter_type &__d) noexcept
       template<typename _Del = deleter_type, typename _DelUnref = typename remove_reference<_Del>::type>
           constexpr unique_ptr (pointer, __enable_if_t< is_lvalue_reference< _Del >::value, _DelUnref &&
           >)=delete
       unique_ptr (unique_ptr &&)=default
           Move constructor.
       template<typename _Up, typename _Ep, typename = _Require<               __safe_conversion_up<_Up, _Ep>,
           __conditional_t<is_reference<_Dp>::value,                   is_same<_Ep, _Dp>,
           is_convertible<_Ep, _Dp>>>> constexpr unique_ptr (unique_ptr< _Up, _Ep > &&__u) noexcept
           Converting constructor from another type.
       ~unique_ptr () noexcept
           Destructor, invokes the deleter if the stored pointer is not null.
       constexpr pointer get () const noexcept
           Return the stored pointer.
       constexpr const deleter_type & get_deleter () const noexcept
           Return a reference to the stored deleter.
       constexpr deleter_type & get_deleter () noexcept
           Return a reference to the stored deleter.
       constexpr operator bool () const noexcept
           Return true if the stored pointer is not null.
       constexpr add_lvalue_reference< element_type >::type operator* () const noexcept(noexcept(*std::declval<
           pointer >()))
           Dereference the stored pointer.
       constexpr pointer operator-> () const noexcept
           Return the stored pointer.
       unique_ptr & operator= (const unique_ptr &)=delete
       constexpr unique_ptr & operator= (nullptr_t) noexcept
           Reset the unique_ptr to empty, invoking the deleter if necessary.
       unique_ptr & operator= (unique_ptr &&)=default
           Move assignment operator.
       template<typename _Up, typename _Ep> constexpr enable_if< __and_< __safe_conversion_up< _Up, _Ep >,
           is_assignable< deleter_type &, _Ep && > >::value, unique_ptr & >::type operator= (unique_ptr< _Up,
           _Ep > &&__u) noexcept
           Assignment from another type.
       constexpr pointer release () noexcept
           Release ownership of any stored pointer.
       constexpr void reset (pointer __p=pointer()) noexcept
           Replace the stored pointer.
       constexpr void swap (unique_ptr &__u) noexcept
           Exchange the pointer and deleter with another object.

   Related Symbols
       (Note that these are not member symbols.)
       template<typename _CharT, typename _Traits, typename _Tp, typename _Dp> basic_ostream< _CharT, _Traits >
           & operator<< (basic_ostream< _CharT, _Traits > &__os, const unique_ptr< _Tp, _Dp > &__p)
           Stream output operator for unique_ptr.
       template<typename _Tp, typename _Dp> constexpr enable_if< __is_swappable< _Dp >::value >::type swap
           (unique_ptr< _Tp, _Dp > &__x, unique_ptr< _Tp, _Dp > &__y) noexcept
           Swap overload for unique_ptr.

Detailed Description

   template<typename _Tp, typename _Dp = default_delete<_Tp>>
       class std::unique_ptr< _Tp, _Dp >"A move-only smart pointer that manages unique ownership of a resource.

       Since
           C++11

Constructor & Destructor Documentation

   template<typename _Tp, typename _Dp = default_delete<_Tp>> template<typename _Del = _Dp, typename =
       _DeleterConstraint<_Del>> std::unique_ptr< _Tp, _Dp >::unique_ptr () [inline],  [constexpr],  [noexcept]
       Default constructor, creates a unique_ptr that owns nothing.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> template<typename _Del = _Dp, typename =
       _DeleterConstraint<_Del>> std::unique_ptr< _Tp, _Dp >::unique_ptr (pointer __p) [inline],  [explicit],
       [constexpr],  [noexcept]
       Takes ownership of a pointer.

       Parameters
           __p A pointer to an object of element_type

       The deleter will be value-initialized.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> template<typename _Del = deleter_type, typename =
       _Require<is_copy_constructible<_Del>>> std::unique_ptr< _Tp, _Dp >::unique_ptr (pointer __p, const
       deleter_type & __d) [inline],  [constexpr],  [noexcept]
       Takes ownership of a pointer.

       Parameters
           __p A pointer to an object of element_type
           __d A reference to a deleter.

       The deleter will be initialized with __d

   template<typename _Tp, typename _Dp = default_delete<_Tp>> template<typename _Del = deleter_type, typename =
       _Require<is_move_constructible<_Del>>> std::unique_ptr< _Tp, _Dp >::unique_ptr (pointer __p,
       __enable_if_t<!is_lvalue_reference< _Del >::value, _Del && > __d) [inline],  [constexpr],  [noexcept]
       Takes ownership of a pointer.

       Parameters
           __p A pointer to an object of element_type
           __d An rvalue reference to a (non-reference) deleter.

       The deleter will be initialized with std::move(__d)

   template<typename _Tp, typename _Dp = default_delete<_Tp>> template<typename _Del = _Dp, typename =
       _DeleterConstraint<_Del>> std::unique_ptr< _Tp, _Dp >::unique_ptr (nullptr_t ) [inline],  [constexpr],
       [noexcept]
       Creates a unique_ptr that owns nothing.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> std::unique_ptr< _Tp, _Dp >::unique_ptr
       (unique_ptr< _Tp, _Dp > && ) [default]
       Move constructor.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> template<typename _Up, typename _Ep, typename =
       _Require<               __safe_conversion_up<_Up, _Ep>,
       __conditional_t<is_reference<_Dp>::value,                   is_same<_Ep, _Dp>,
       is_convertible<_Ep, _Dp>>>> std::unique_ptr< _Tp, _Dp >::unique_ptr (unique_ptr< _Up, _Ep > && __u)
       [inline],  [constexpr],  [noexcept]
       Converting constructor from another type. Requires that the pointer owned by __u is convertible to the
       type of pointer owned by this object, __u does not own an array, and __u has a compatible deleter type.

   template<typename _Tp, typename _Dp> template<typename _Up, typename> std::unique_ptr< _Tp, _Dp >::unique_ptr
       (auto_ptr< _Up > && __u) [inline],  [noexcept]
       Converting constructor from auto_ptr.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> std::unique_ptr< _Tp, _Dp >::~unique_ptr ()
       [inline],  [noexcept]
       Destructor, invokes the deleter if the stored pointer is not null.

Member Function Documentation

   template<typename _Tp, typename _Dp = default_delete<_Tp>> pointer std::unique_ptr< _Tp, _Dp >::get () const
       [inline],  [constexpr],  [noexcept]
       Return the stored pointer.

       Referenced by std::unique_ptr< _State >::operator bool(), std::unique_ptr< _State >::operator*(),
       std::unique_ptr< _State >::operator->(), std::operator<(), std::operator<(), std::operator<(),
       std::unique_ptr< _State >::operator<<(), std::operator==(), std::operator>(), and std::operator>().

   template<typename _Tp, typename _Dp = default_delete<_Tp>> const deleter_type & std::unique_ptr< _Tp, _Dp
       >::get_deleter () const [inline],  [constexpr],  [noexcept]
       Return a reference to the stored deleter.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> deleter_type & std::unique_ptr< _Tp, _Dp
       >::get_deleter () [inline],  [constexpr],  [noexcept]
       Return a reference to the stored deleter.

       Referenced by std::unique_ptr< _State >::~unique_ptr(), and std::unique_ptr< _State >::operator=().

   template<typename _Tp, typename _Dp = default_delete<_Tp>> std::unique_ptr< _Tp, _Dp >::operator bool ()
       const [inline],  [explicit],  [constexpr],  [noexcept]
       Return true if the stored pointer is not null.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> add_lvalue_reference< element_type >::type
       std::unique_ptr< _Tp, _Dp >::operator* () const [inline],  [constexpr],  [noexcept]
       Dereference the stored pointer.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> pointer std::unique_ptr< _Tp, _Dp >::operator-> ()
       const [inline],  [constexpr],  [noexcept]
       Return the stored pointer.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> unique_ptr & std::unique_ptr< _Tp, _Dp
       >::operator= (nullptr_t ) [inline],  [constexpr],  [noexcept]
       Reset the unique_ptr to empty, invoking the deleter if necessary.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> unique_ptr & std::unique_ptr< _Tp, _Dp
       >::operator= (unique_ptr< _Tp, _Dp > && ) [default]
       Move assignment operator. Invokes the deleter if this object owns a pointer.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> template<typename _Up, typename _Ep> enable_if<
       __and_< __safe_conversion_up< _Up, _Ep >, is_assignable< deleter_type &, _Ep && > >::value, unique_ptr &
       >::type std::unique_ptr< _Tp, _Dp >::operator= (unique_ptr< _Up, _Ep > && __u) [inline],  [constexpr],
       [noexcept]
       Assignment from another type.

       Parameters
           __u The object to transfer ownership from, which owns a convertible pointer to a non-array object.

       Invokes the deleter if this object owns a pointer.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> pointer std::unique_ptr< _Tp, _Dp >::release ()
       [inline],  [constexpr],  [noexcept]
       Release ownership of any stored pointer.

   template<typename _Tp, typename _Dp = default_delete<_Tp>> void std::unique_ptr< _Tp, _Dp >::reset (pointer
       __p = pointer()) [inline],  [constexpr],  [noexcept]
       Replace the stored pointer.

       Parameters
           __p The new pointer to store.

       The deleter will be invoked if a pointer is already owned.

       Referenced by std::unique_ptr< _State >::operator=(), and std::unique_ptr< _State >::operator=().

   template<typename _Tp, typename _Dp = default_delete<_Tp>> void std::unique_ptr< _Tp, _Dp >::swap
       (unique_ptr< _Tp, _Dp > & __u) [inline],  [constexpr],  [noexcept]
       Exchange the pointer and deleter with another object.

Author

       Generated automatically by Doxygen for libstdc++ from the source code.

                                                    libstdc++                  std::unique_ptr< _Tp, _Dp >(3cxx)