| std::unique_ptr< _Tp, _Dp >(3cxx) | std::unique_ptr< _Tp, _Dp >(3cxx) | 
NAME¶
std::unique_ptr< _Tp, _Dp > - 20.7.1.2 unique_ptr for single objects.
SYNOPSIS¶
#include <unique_ptr.h>
Public Types¶
using deleter_type = _Dp
  
  using element_type = _Tp
  
  using pointer = typename __uniq_ptr_impl< _Tp,
    _Dp >::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 > unique_ptr
    (auto_ptr< _Up > &&__u) noexcept
  
  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>>
    unique_ptr (pointer __p) noexcept
  
  template<typename _Del = deleter_type, typename =
    _Require<is_move_constructible<_Del>>> 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>>> unique_ptr
    (pointer __p, const deleter_type &__d) noexcept
  
  template<typename _Del = deleter_type, typename
    _DelUnref = typename remove_reference<_Del>::type>
    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>,	
    typename conditional<is_reference<_Dp>::value,				 is_same<_Ep,
    _Dp>,				 is_convertible<_Ep, _Dp>>::type>>
    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. pointer
    get () const noexcept
  
  Return the stored pointer. const deleter_type &
    get_deleter () const noexcept
  
  Return a reference to the stored deleter. deleter_type &
    get_deleter () noexcept
  
  Return a reference to the stored deleter. operator bool () const
    noexcept
  
  Return true if the stored pointer is not null. 
    add_lvalue_reference< element_type >::type operator* ()
    const
  
  Dereference the stored pointer. pointer operator-> () const
    noexcept
  
  Return the stored pointer. unique_ptr & operator=
    (const unique_ptr &)=delete
  
  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 > 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. pointer release () noexcept
  
  Release ownership of any stored pointer. void reset (pointer
    __p=pointer()) noexcept
  
  Replace the stored pointer. 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 _Tp , typename _Dp >
    enable_if< __is_swappable< _Dp >::value
    >::type swap (unique_ptr< _Tp, _Dp > &__x,
    unique_ptr< _Tp, _Dp > &__y) noexcept
  
  template<typename _Tp , typename _Dp , typename
    _Up , typename _Ep > bool operator== (const
    unique_ptr< _Tp, _Dp > &__x, const
    unique_ptr< _Up, _Ep > &__y)
  
  Equality operator for unique_ptr objects, compares the owned pointers.
    template<typename _Tp , typename _Dp > bool
    operator== (const unique_ptr< _Tp, _Dp >
    &__x, nullptr_t) noexcept
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp > bool operator== (nullptr_t,
    const unique_ptr< _Tp, _Dp > &__x)
    noexcept
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp , typename _Up , typename
    _Ep > bool operator!= (const unique_ptr<
    _Tp, _Dp > &__x, const unique_ptr< _Up,
    _Ep > &__y)
  
  Inequality operator for unique_ptr objects, compares the owned pointers.
    template<typename _Tp , typename _Dp > bool
    operator!= (const unique_ptr< _Tp, _Dp >
    &__x, nullptr_t) noexcept
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp > bool operator!= (nullptr_t,
    const unique_ptr< _Tp, _Dp > &__x)
    noexcept
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp , typename _Up , typename
    _Ep > bool operator< (const unique_ptr<
    _Tp, _Dp > &__x, const unique_ptr< _Up,
    _Ep > &__y)
  
  Relational operator for unique_ptr objects, compares the owned pointers.
    template<typename _Tp , typename _Dp > bool
    operator< (const unique_ptr< _Tp, _Dp >
    &__x, nullptr_t)
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp > bool operator< (nullptr_t,
    const unique_ptr< _Tp, _Dp > &__x)
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp , typename _Up , typename
    _Ep > bool operator<= (const
    unique_ptr< _Tp, _Dp > &__x, const
    unique_ptr< _Up, _Ep > &__y)
  
  Relational operator for unique_ptr objects, compares the owned pointers.
    template<typename _Tp , typename _Dp > bool
    operator<= (const unique_ptr< _Tp, _Dp
    > &__x, nullptr_t)
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp > bool operator<= (nullptr_t,
    const unique_ptr< _Tp, _Dp > &__x)
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp , typename _Up , typename
    _Ep > bool operator> (const unique_ptr<
    _Tp, _Dp > &__x, const unique_ptr< _Up,
    _Ep > &__y)
  
  Relational operator for unique_ptr objects, compares the owned pointers.
    template<typename _Tp , typename _Dp > bool
    operator> (const unique_ptr< _Tp, _Dp >
    &__x, nullptr_t)
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp > bool operator> (nullptr_t,
    const unique_ptr< _Tp, _Dp > &__x)
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp , typename _Up , typename
    _Ep > bool operator>= (const
    unique_ptr< _Tp, _Dp > &__x, const
    unique_ptr< _Up, _Ep > &__y)
  
  Relational operator for unique_ptr objects, compares the owned pointers.
    template<typename _Tp , typename _Dp > bool
    operator>= (const unique_ptr< _Tp, _Dp
    > &__x, nullptr_t)
  
  unique_ptr comparison with nullptr template<typename _Tp ,
    typename _Dp > bool operator>= (nullptr_t,
    const unique_ptr< _Tp, _Dp > &__x)
  
  unique_ptr comparison with nullptr
  
  
  
  
  template<typename _Tp , typename... _Args> _MakeUniq<
    _Tp >::__single_object make_unique (_Args &&...
    __args)
  
  std::make_unique for single objects template<typename _Tp >
    _MakeUniq< _Tp >::__array make_unique (size_t
    __num)
  
  std::make_unique for arrays of unknown bound template<typename _Tp ,
    typename... _Args> _MakeUniq< _Tp >::__invalid_type
    make_unique (_Args &&...)=delete
  
  Disable std::make_unique for arrays of known bound.
  
  
Detailed Description¶
template<typename _Tp, typename _Dp = default_delete<_Tp>>¶
class std::unique_ptr< _Tp, _Dp >"20.7.1.2 unique_ptr for single objects.
Constructor & Destructor Documentation¶
template<typename _Tp , typename _Dp = default_delete<_Tp>> template<typename _Del = _Dp, typename = _DeleterConstraint<_Del>> constexpr 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], [noexcept]¶
Takes ownership of a pointer.
Parameters
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], [noexcept]¶
Takes ownership of a pointer.
Parameters
__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], [noexcept]¶
Takes ownership of a pointer.
Parameters
__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>> constexpr 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>, typename conditional<is_reference<_Dp>::value, is_same<_Ep, _Dp>, is_convertible<_Ep, _Dp>>::type>> std::unique_ptr< _Tp, _Dp >::unique_ptr (unique_ptr< _Up, _Ep > && __u) [inline], [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 = default_delete<_Tp>> std::unique_ptr< _Tp, _Dp >::~unique_ptr () [inline], [noexcept]¶
Destructor, invokes the deleter if the stored pointer is not null.
References std::unique_ptr< _Tp, _Dp >::get_deleter(), and std::move().
Member Function Documentation¶
template<typename _Tp , typename _Dp = default_delete<_Tp>> pointer std::unique_ptr< _Tp, _Dp >::get () const [inline], [noexcept]¶
Return the stored pointer.
Referenced by std::unique_ptr< _Tp, _Dp >::operator bool(), std::unique_ptr< _Tp[], _Dp >::operator bool(), std::unique_ptr< _Tp, _Dp >::operator*(), std::unique_ptr< _Tp, _Dp >::operator->(), and std::unique_ptr< _Tp[], _Dp >::operator[]().
template<typename _Tp , typename _Dp = default_delete<_Tp>> const deleter_type & std::unique_ptr< _Tp, _Dp >::get_deleter () const [inline], [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], [noexcept]¶
Return a reference to the stored deleter.
Referenced by std::unique_ptr< _Tp[], _Dp >::~unique_ptr(), std::unique_ptr< _Tp, _Dp >::~unique_ptr(), std::unique_ptr< _Tp, _Dp >::operator=(), and std::unique_ptr< _Tp[], _Dp >::operator=().
template<typename _Tp , typename _Dp = default_delete<_Tp>> std::unique_ptr< _Tp, _Dp >::operator bool () const [inline], [explicit], [noexcept]¶
Return true if the stored pointer is not null.
References std::unique_ptr< _Tp, _Dp >::get().
template<typename _Tp , typename _Dp = default_delete<_Tp>> add_lvalue_reference< element_type >::type std::unique_ptr< _Tp, _Dp >::operator* () const [inline]¶
Dereference the stored pointer.
References std::unique_ptr< _Tp, _Dp >::get().
template<typename _Tp , typename _Dp = default_delete<_Tp>> pointer std::unique_ptr< _Tp, _Dp >::operator-> () const [inline], [noexcept]¶
Return the stored pointer.
References std::unique_ptr< _Tp, _Dp >::get().
template<typename _Tp , typename _Dp = default_delete<_Tp>> unique_ptr & std::unique_ptr< _Tp, _Dp >::operator= (nullptr_t) [inline], [noexcept]¶
Reset the unique_ptr to empty, invoking the deleter if necessary.
References std::unique_ptr< _Tp, _Dp >::reset().
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], [noexcept]¶
Assignment from another type.
Parameters
Invokes the deleter if this object owns a pointer.
References std::unique_ptr< _Tp, _Dp >::get_deleter(), and std::unique_ptr< _Tp, _Dp >::reset().
template<typename _Tp , typename _Dp = default_delete<_Tp>> pointer std::unique_ptr< _Tp, _Dp >::release () [inline], [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], [noexcept]¶
Replace the stored pointer.
Parameters
The deleter will be invoked if a pointer is already owned.
References std::move().
Referenced by std::unique_ptr< _Tp, _Dp >::operator=(), std::unique_ptr< _Tp[], _Dp >::operator=(), std::unique_ptr< _Tp, _Dp >::operator=(), and std::unique_ptr< _Tp[], _Dp >::operator=().
template<typename _Tp , typename _Dp = default_delete<_Tp>> void std::unique_ptr< _Tp, _Dp >::swap (unique_ptr< _Tp, _Dp > & __u) [inline], [noexcept]¶
Exchange the pointer and deleter with another object.
Author¶
Generated automatically by Doxygen for libstdc++ from the source code.
| libstdc++ |