libstdc++
std::unique_ptr< _Tp[], _Dp > Class Template Reference

#include <memory>

Public Types

template<typename _Up>
using __safe_conversion_raw
 
template<typename _Up, typename _Ep, typename _UPtr = unique_ptr<_Up, _Ep>, typename _UP_pointer = typename _UPtr::pointer, typename _UP_element_type = typename _UPtr::element_type>
using __safe_conversion_up
 
using deleter_type
 
using deleter_type
 
using element_type
 
using element_type
 
using pointer
 
using pointer
 

Public Member Functions

constexpr unique_ptr () noexcept
 
template<typename _Del = _Dp, typename = _DeleterConstraint<_Del>>
constexpr unique_ptr () noexcept
 
template<typename _Up, typename _Vp = _Dp, typename = _DeleterConstraint<_Vp>, typename = typename enable_if< __safe_conversion_raw<_Up>::value, bool>::type>
constexpr unique_ptr (_Up __p) noexcept
 
template<typename _Up, typename _Del = deleter_type, typename = _Require<__safe_conversion_raw<_Up>, is_move_constructible<_Del>>>
constexpr unique_ptr (_Up __p, __enable_if_t<!is_lvalue_reference< _Del >::value, _Del && > __d) noexcept
 
template<typename _Up, typename _Del = deleter_type, typename = _Require<__safe_conversion_raw<_Up>, is_copy_constructible<_Del>>>
constexpr unique_ptr (_Up __p, const deleter_type &__d) noexcept
 
template<typename _Up, typename _Del = deleter_type, typename _DelUnref = typename remove_reference<_Del>::type, typename = _Require<__safe_conversion_raw<_Up>>>
 unique_ptr (_Up, __enable_if_t< is_lvalue_reference< _Del >::value, _DelUnref && >)=delete
 
 unique_ptr (auto_ptr< _Up > &&__u) noexcept
 
 unique_ptr (const unique_ptr &)=delete
 
 unique_ptr (const unique_ptr &)=delete
 
constexpr unique_ptr (nullptr_t) noexcept
 
template<typename _Del = _Dp, typename = _DeleterConstraint<_Del>>
constexpr unique_ptr (nullptr_t) noexcept
 
constexpr unique_ptr (pointer __p) noexcept
 
constexpr unique_ptr (pointer __p, __enable_if_t<!is_lvalue_reference< _Del >::value, _Del && > __d) noexcept
 
constexpr unique_ptr (pointer __p, const deleter_type &__d) noexcept
 
constexpr unique_ptr (pointer, __enable_if_t< is_lvalue_reference< _Del >::value, _DelUnref && >)=delete
 
 unique_ptr (unique_ptr &&)=default
 
 unique_ptr (unique_ptr &&)=default
 
constexpr unique_ptr (unique_ptr< _Up, _Ep > &&__u) noexcept
 
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
 
 ~unique_ptr ()
 
 ~unique_ptr () noexcept
 
constexpr pointer get () const noexcept
 
constexpr pointer get () const noexcept
 
constexpr const deleter_type & get_deleter () const noexcept
 
constexpr const deleter_type & get_deleter () const noexcept
 
constexpr deleter_type & get_deleter () noexcept
 
constexpr deleter_type & get_deleter () noexcept
 
constexpr operator bool () const noexcept
 
constexpr operator bool () const noexcept
 
constexpr add_lvalue_reference< element_type >::type operator* () const noexcept(noexcept(*std::declval< pointer >()))
 
constexpr pointer operator-> () const noexcept
 
unique_ptroperator= (const unique_ptr &)=delete
 
unique_ptroperator= (const unique_ptr &)=delete
 
constexpr unique_ptroperator= (nullptr_t) noexcept
 
constexpr unique_ptroperator= (nullptr_t) noexcept
 
unique_ptroperator= (unique_ptr &&)=default
 
unique_ptroperator= (unique_ptr &&)=default
 
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
 
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
 
constexpr std::add_lvalue_reference< element_type >::type operator[] (size_t __i) const
 
constexpr pointer release () noexcept
 
constexpr pointer release () noexcept
 
template<typename _Up, typename = _Require< __or_<is_same<_Up, pointer>, __and_<is_same<pointer, element_type*>, is_pointer<_Up>, is_convertible< typename remove_pointer<_Up>::type(*)[], element_type(*)[] > > > >>
constexpr void reset (_Up __p) noexcept
 
constexpr void reset (nullptr_t=nullptr) noexcept
 
constexpr void reset (pointer __p=pointer()) noexcept
 
constexpr void swap (unique_ptr &__u) noexcept
 
constexpr void swap (unique_ptr &__u) noexcept
 

Related Symbols

(Note that these are not member symbols.)

basic_ostream< _CharT, _Traits > & operator<< (basic_ostream< _CharT, _Traits > &__os, const unique_ptr< _Tp, _Dp > &__p)
 
basic_ostream< _CharT, _Traits > & operator<< (basic_ostream< _CharT, _Traits > &__os, const unique_ptr< _Tp, _Dp > &__p)
 
constexpr enable_if< __is_swappable< _Dp >::value >::type swap (unique_ptr< _Tp, _Dp > &__x, unique_ptr< _Tp, _Dp > &__y) noexcept
 
constexpr enable_if< __is_swappable< _Dp >::value >::type swap (unique_ptr< _Tp, _Dp > &__x, unique_ptr< _Tp, _Dp > &__y) noexcept
 

Detailed Description

template<typename _Tp, typename _Dp>
class std::unique_ptr< _Tp[], _Dp >

A move-only smart pointer that manages unique ownership of an array.

Since
C++11

Definition at line 546 of file unique_ptr.h.

Member Typedef Documentation

◆ __safe_conversion_raw

template<typename _Tp, typename _Dp>
template<typename _Up>
using std::unique_ptr< _Tp[], _Dp >::__safe_conversion_raw

Definition at line 579 of file unique_ptr.h.

◆ __safe_conversion_up

template<typename _Tp, typename _Dp>
template<typename _Up, typename _Ep, typename _UPtr = unique_ptr<_Up, _Ep>, typename _UP_pointer = typename _UPtr::pointer, typename _UP_element_type = typename _UPtr::element_type>
using std::unique_ptr< _Tp[], _Dp >::__safe_conversion_up

Definition at line 570 of file unique_ptr.h.

◆ deleter_type [1/2]

using std::unique_ptr< _Tp, _Dp >::deleter_type

Definition at line 282 of file unique_ptr.h.

◆ deleter_type [2/2]

template<typename _Tp, typename _Dp>
using std::unique_ptr< _Tp[], _Dp >::deleter_type

Definition at line 562 of file unique_ptr.h.

◆ element_type [1/2]

using std::unique_ptr< _Tp, _Dp >::element_type

Definition at line 281 of file unique_ptr.h.

◆ element_type [2/2]

template<typename _Tp, typename _Dp>
using std::unique_ptr< _Tp[], _Dp >::element_type

Definition at line 561 of file unique_ptr.h.

◆ pointer [1/2]

using std::unique_ptr< _Tp, _Dp >::pointer

Definition at line 280 of file unique_ptr.h.

◆ pointer [2/2]

template<typename _Tp, typename _Dp>
using std::unique_ptr< _Tp[], _Dp >::pointer

Definition at line 560 of file unique_ptr.h.

Constructor & Destructor Documentation

◆ unique_ptr() [1/15]

template<typename _Tp, typename _Dp>
template<typename _Del = _Dp, typename = _DeleterConstraint<_Del>>
std::unique_ptr< _Tp[], _Dp >::unique_ptr ( )
inlineconstexprnoexcept

Default constructor, creates a unique_ptr that owns nothing.

Definition at line 595 of file unique_ptr.h.

References unique_ptr().

Referenced by unique_ptr(), unique_ptr(), unique_ptr(), unique_ptr(), unique_ptr(), unique_ptr(), ~unique_ptr(), operator=(), operator=(), operator=(), and swap().

◆ unique_ptr() [2/15]

template<typename _Tp, typename _Dp>
template<typename _Up, typename _Vp = _Dp, typename = _DeleterConstraint<_Vp>, typename = typename enable_if< __safe_conversion_raw<_Up>::value, bool>::type>
std::unique_ptr< _Tp[], _Dp >::unique_ptr ( _Up __p)
inlineexplicitconstexprnoexcept

Takes ownership of a pointer.

Parameters
__pA pointer to an array of a type safely convertible to an array of element_type

The deleter will be value-initialized.

Definition at line 613 of file unique_ptr.h.

References unique_ptr().

◆ unique_ptr() [3/15]

template<typename _Tp, typename _Dp>
template<typename _Up, typename _Del = deleter_type, typename = _Require<__safe_conversion_raw<_Up>, is_copy_constructible<_Del>>>
std::unique_ptr< _Tp[], _Dp >::unique_ptr ( _Up __p,
const deleter_type & __d )
inlineconstexprnoexcept

Takes ownership of a pointer.

Parameters
__pA pointer to an array of a type safely convertible to an array of element_type
__dA reference to a deleter.

The deleter will be initialized with __d

Definition at line 629 of file unique_ptr.h.

References unique_ptr().

◆ unique_ptr() [4/15]

template<typename _Tp, typename _Dp>
template<typename _Up, typename _Del = deleter_type, typename = _Require<__safe_conversion_raw<_Up>, is_move_constructible<_Del>>>
std::unique_ptr< _Tp[], _Dp >::unique_ptr ( _Up __p,
__enable_if_t<!is_lvalue_reference< _Del >::value, _Del && > __d )
inlineconstexprnoexcept

Takes ownership of a pointer.

Parameters
__pA pointer to an array of a type safely convertible to an array of element_type
__dA reference to a deleter.

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

Definition at line 644 of file unique_ptr.h.

References unique_ptr(), and std::move().

◆ unique_ptr() [5/15]

template<typename _Tp, typename _Dp>
std::unique_ptr< _Tp[], _Dp >::unique_ptr ( unique_ptr< _Tp[], _Dp > && )
default

Move constructor.

References unique_ptr().

◆ unique_ptr() [6/15]

template<typename _Tp, typename _Dp>
template<typename _Del = _Dp, typename = _DeleterConstraint<_Del>>
std::unique_ptr< _Tp[], _Dp >::unique_ptr ( nullptr_t )
inlineconstexprnoexcept

Creates a unique_ptr that owns nothing.

Definition at line 662 of file unique_ptr.h.

References unique_ptr().

◆ unique_ptr() [7/15]

template<typename _Tp, typename _Dp>
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)
inlineconstexprnoexcept

Definition at line 672 of file unique_ptr.h.

◆ ~unique_ptr() [1/2]

template<typename _Tp, typename _Dp>
std::unique_ptr< _Tp[], _Dp >::~unique_ptr ( )
inline

Destructor, invokes the deleter if the stored pointer is not null.

Definition at line 680 of file unique_ptr.h.

References unique_ptr(), and get_deleter().

◆ unique_ptr() [8/15]

std::unique_ptr< _Tp, _Dp >::unique_ptr ( )
inlineconstexprnoexcept

Default constructor, creates a unique_ptr that owns nothing.

Definition at line 298 of file unique_ptr.h.

◆ unique_ptr() [9/15]

std::unique_ptr< _Tp, _Dp >::unique_ptr ( pointer __p)
inlineexplicitconstexprnoexcept

Takes ownership of a pointer.

Parameters
__pA pointer to an object of element_type

The deleter will be value-initialized.

Definition at line 311 of file unique_ptr.h.

◆ unique_ptr() [10/15]

std::unique_ptr< _Tp, _Dp >::unique_ptr ( pointer __p,
const deleter_type & __d )
inlineconstexprnoexcept

Takes ownership of a pointer.

Parameters
__pA pointer to an object of element_type
__dA reference to a deleter.

The deleter will be initialized with __d

Definition at line 325 of file unique_ptr.h.

◆ unique_ptr() [11/15]

std::unique_ptr< _Tp, _Dp >::unique_ptr ( pointer __p,
__enable_if_t<!is_lvalue_reference< _Del >::value, _Del && > __d )
inlineconstexprnoexcept

Takes ownership of a pointer.

Parameters
__pA pointer to an object of element_type
__dAn rvalue reference to a (non-reference) deleter.

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

Definition at line 338 of file unique_ptr.h.

◆ unique_ptr() [12/15]

std::unique_ptr< _Tp, _Dp >::unique_ptr ( nullptr_t )
inlineconstexprnoexcept

Creates a unique_ptr that owns nothing.

Definition at line 353 of file unique_ptr.h.

◆ unique_ptr() [13/15]

std::unique_ptr< _Tp, _Dp >::unique_ptr ( unique_ptr< _Tp[], _Dp > && )
default

Move constructor.

◆ unique_ptr() [14/15]

std::unique_ptr< _Tp, _Dp >::unique_ptr ( unique_ptr< _Up, _Ep > && __u)
inlineconstexprnoexcept

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.

Definition at line 374 of file unique_ptr.h.

◆ unique_ptr() [15/15]

std::unique_ptr< _Tp, _Dp >::unique_ptr ( auto_ptr< _Up > && __u)
inlinenoexcept

Converting constructor from auto_ptr.

Definition at line 385 of file auto_ptr.h.

◆ ~unique_ptr() [2/2]

std::unique_ptr< _Tp, _Dp >::~unique_ptr ( )
inlinenoexcept

Destructor, invokes the deleter if the stored pointer is not null.

Definition at line 393 of file unique_ptr.h.

Member Function Documentation

◆ get() [1/2]

pointer std::unique_ptr< _Tp, _Dp >::get ( ) const
inlineconstexprnoexcept

Return the stored pointer.

Definition at line 472 of file unique_ptr.h.

◆ get() [2/2]

template<typename _Tp, typename _Dp>
pointer std::unique_ptr< _Tp[], _Dp >::get ( ) const
inlineconstexprnoexcept

Return the stored pointer.

Definition at line 741 of file unique_ptr.h.

References get().

Referenced by get(), operator bool(), and operator[]().

◆ get_deleter() [1/4]

const deleter_type & std::unique_ptr< _Tp, _Dp >::get_deleter ( ) const
inlineconstexprnoexcept

Return a reference to the stored deleter.

Definition at line 484 of file unique_ptr.h.

◆ get_deleter() [2/4]

template<typename _Tp, typename _Dp>
const deleter_type & std::unique_ptr< _Tp[], _Dp >::get_deleter ( ) const
inlineconstexprnoexcept

Return a reference to the stored deleter.

Definition at line 753 of file unique_ptr.h.

References get_deleter().

◆ get_deleter() [3/4]

deleter_type & std::unique_ptr< _Tp, _Dp >::get_deleter ( )
inlineconstexprnoexcept

Return a reference to the stored deleter.

Definition at line 478 of file unique_ptr.h.

◆ get_deleter() [4/4]

template<typename _Tp, typename _Dp>
deleter_type & std::unique_ptr< _Tp[], _Dp >::get_deleter ( )
inlineconstexprnoexcept

Return a reference to the stored deleter.

Definition at line 747 of file unique_ptr.h.

References get_deleter().

Referenced by ~unique_ptr(), get_deleter(), get_deleter(), and operator=().

◆ operator bool() [1/2]

std::unique_ptr< _Tp, _Dp >::operator bool ( ) const
inlineexplicitconstexprnoexcept

Return true if the stored pointer is not null.

Definition at line 489 of file unique_ptr.h.

◆ operator bool() [2/2]

template<typename _Tp, typename _Dp>
std::unique_ptr< _Tp[], _Dp >::operator bool ( ) const
inlineexplicitconstexprnoexcept

Return true if the stored pointer is not null.

Definition at line 758 of file unique_ptr.h.

References get().

◆ operator*()

add_lvalue_reference< element_type >::type std::unique_ptr< _Tp, _Dp >::operator* ( ) const
inlineconstexprnoexcept

Dereference the stored pointer.

Definition at line 446 of file unique_ptr.h.

◆ operator->()

pointer std::unique_ptr< _Tp, _Dp >::operator-> ( ) const
inlineconstexprnoexcept

Return the stored pointer.

Definition at line 463 of file unique_ptr.h.

◆ operator=() [1/6]

unique_ptr & std::unique_ptr< _Tp, _Dp >::operator= ( nullptr_t )
inlineconstexprnoexcept

Reset the unique_ptr to empty, invoking the deleter if necessary.

Definition at line 435 of file unique_ptr.h.

◆ operator=() [2/6]

template<typename _Tp, typename _Dp>
unique_ptr & std::unique_ptr< _Tp[], _Dp >::operator= ( nullptr_t )
inlineconstexprnoexcept

Reset the unique_ptr to empty, invoking the deleter if necessary.

Definition at line 721 of file unique_ptr.h.

References unique_ptr(), operator=(), and reset().

◆ operator=() [3/6]

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.

◆ operator=() [4/6]

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

References unique_ptr(), and operator=().

Referenced by operator=(), operator=(), and operator=().

◆ operator=() [5/6]

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)
inlineconstexprnoexcept

Assignment from another type.

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

Invokes the deleter if this object owns a pointer.

Definition at line 425 of file unique_ptr.h.

◆ operator=() [6/6]

template<typename _Tp, typename _Dp>
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)
inlineconstexprnoexcept

Assignment from another type.

Parameters
__uThe object to transfer ownership from, which owns a convertible pointer to an array object.

Invokes the deleter if this object owns a pointer.

Definition at line 711 of file unique_ptr.h.

References unique_ptr(), std::forward(), get_deleter(), operator=(), and reset().

◆ operator[]()

template<typename _Tp, typename _Dp>
std::add_lvalue_reference< element_type >::type std::unique_ptr< _Tp[], _Dp >::operator[] ( size_t __i) const
inlineconstexpr

Access an element of owned array.

Definition at line 732 of file unique_ptr.h.

References get(), and operator[]().

Referenced by operator[]().

◆ release() [1/2]

pointer std::unique_ptr< _Tp, _Dp >::release ( )
inlineconstexprnoexcept

Release ownership of any stored pointer.

Definition at line 497 of file unique_ptr.h.

◆ release() [2/2]

template<typename _Tp, typename _Dp>
pointer std::unique_ptr< _Tp[], _Dp >::release ( )
inlineconstexprnoexcept

Release ownership of any stored pointer.

Definition at line 766 of file unique_ptr.h.

References release().

Referenced by release().

◆ reset() [1/3]

template<typename _Tp, typename _Dp>
template<typename _Up, typename = _Require< __or_<is_same<_Up, pointer>, __and_<is_same<pointer, element_type*>, is_pointer<_Up>, is_convertible< typename remove_pointer<_Up>::type(*)[], element_type(*)[] > > > >>
void std::unique_ptr< _Tp[], _Dp >::reset ( _Up __p)
inlineconstexprnoexcept

Replace the stored pointer.

Parameters
__pThe new pointer to store.

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

Definition at line 789 of file unique_ptr.h.

References std::move(), and reset().

Referenced by operator=(), operator=(), and reset().

◆ reset() [2/3]

template<typename _Tp, typename _Dp>
void std::unique_ptr< _Tp[], _Dp >::reset ( nullptr_t = nullptr)
inlineconstexprnoexcept

Definition at line 793 of file unique_ptr.h.

◆ reset() [3/3]

void std::unique_ptr< _Tp, _Dp >::reset ( pointer __p = pointer())
inlineconstexprnoexcept

Replace the stored pointer.

Parameters
__pThe new pointer to store.

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

Definition at line 508 of file unique_ptr.h.

◆ swap() [1/2]

void std::unique_ptr< _Tp, _Dp >::swap ( unique_ptr< _Tp[], _Dp > & __u)
inlineconstexprnoexcept

Exchange the pointer and deleter with another object.

Definition at line 518 of file unique_ptr.h.

◆ swap() [2/2]

template<typename _Tp, typename _Dp>
void std::unique_ptr< _Tp[], _Dp >::swap ( unique_ptr< _Tp[], _Dp > & __u)
inlineconstexprnoexcept

Exchange the pointer and deleter with another object.

Definition at line 799 of file unique_ptr.h.

References unique_ptr(), and swap().

Referenced by swap().

Friends And Related Symbol Documentation

◆ operator<<() [1/2]

basic_ostream< _CharT, _Traits > & operator<< ( basic_ostream< _CharT, _Traits > & __os,
const unique_ptr< _Tp, _Dp > & __p )
related

Stream output operator for unique_ptr.

Since
C++20

Definition at line 1013 of file unique_ptr.h.

◆ operator<<() [2/2]

basic_ostream< _CharT, _Traits > & operator<< ( basic_ostream< _CharT, _Traits > & __os,
const unique_ptr< _Tp, _Dp > & __p )
related

Stream output operator for unique_ptr.

Since
C++20

Definition at line 1013 of file unique_ptr.h.

◆ swap() [1/2]

enable_if< __is_swappable< _Dp >::value >::type swap ( unique_ptr< _Tp, _Dp > & __x,
unique_ptr< _Tp, _Dp > & __y )
related

Swap overload for unique_ptr.

Definition at line 830 of file unique_ptr.h.

◆ swap() [2/2]

enable_if< __is_swappable< _Dp >::value >::type swap ( unique_ptr< _Tp, _Dp > & __x,
unique_ptr< _Tp, _Dp > & __y )
related

Swap overload for unique_ptr.

Definition at line 830 of file unique_ptr.h.


The documentation for this class was generated from the following files: