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
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 Functions
(Note that these are not member functions.)
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
__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],
[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], [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>>
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 (void) 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.
template<typename _Tp , typename _Dp = default_delete<_Tp>> pointer
std::unique_ptr< _Tp, _Dp >::operator-> () const [inline], [noexcept]
Return the stored pointer.
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
__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.
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
__p The new pointer to store.
The deleter will be invoked if a pointer is already owned.
References std::move().
Referenced by 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++ Sat May 13 20std::unique_ptr< _Tp, _Dp >(3cxx)
Generated by dwww version 1.14 on Thu Jan 23 20:04:33 CET 2025.