std::unique_ptr - Man Page

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*, _Tp*>, 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.

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>> 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>> constexpr 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>>> constexpr 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>>> constexpr 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>> 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>,       __conditional_t<is_reference<_Dp>::value,       is_same<_Ep, _Dp>,       is_convertible<_Ep, _Dp>>>> constexpr 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.

References std::unique_ptr< _Tp, _Dp >::get_deleter(), and std::move().

Member Function Documentation

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

Return the stored pointer.

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

template<typename _Tp , typename _Dp  = default_delete<_Tp>> constexpr 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>> constexpr deleter_type & std::unique_ptr< _Tp, _Dp >::get_deleter () [inline], [constexpr], [noexcept]

Return a reference to the stored deleter.

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

template<typename _Tp , typename _Dp  = default_delete<_Tp>> constexpr std::unique_ptr< _Tp, _Dp >::operator bool () const [inline], [explicit], [constexpr], [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>> constexpr add_lvalue_reference< element_type >::type std::unique_ptr< _Tp, _Dp >::operator* () const [inline], [constexpr], [noexcept]

Dereference the stored pointer.

References std::unique_ptr< _Tp, _Dp >::get().

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

Return the stored pointer.

References std::unique_ptr< _Tp, _Dp >::get().

template<typename _Tp , typename _Dp  = default_delete<_Tp>> constexpr unique_ptr & std::unique_ptr< _Tp, _Dp >::operator= (nullptr_t) [inline], [constexpr], [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 > constexpr 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.

References std::unique_ptr< _Tp, _Dp >::get_deleter(), and std::unique_ptr< _Tp, _Dp >::reset().

template<typename _Tp , typename _Dp  = default_delete<_Tp>> constexpr pointer std::unique_ptr< _Tp, _Dp >::release () [inline], [constexpr], [noexcept]

Release ownership of any stored pointer.

template<typename _Tp , typename _Dp  = default_delete<_Tp>> constexpr 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.

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>> constexpr 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.

Info

libstdc++