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

#include <unique_ptr.h>

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 element_type
using pointer

Public Member Functions

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>
 unique_ptr (_Up __p) noexcept
template<typename _Up, typename _Del = deleter_type, typename = _Require<__safe_conversion_raw<_Up>, is_move_constructible<_Del>>>
 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>>>
 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
template<typename _Del = _Dp, typename = _DeleterConstraint<_Del>>
constexpr unique_ptr (nullptr_t) noexcept
 unique_ptr (unique_ptr &&)=default
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
 ~unique_ptr ()
pointer get () const noexcept
const deleter_type & get_deleter () const noexcept
deleter_type & get_deleter () noexcept
 operator bool () const noexcept
add_lvalue_reference< element_type >::type operator* () const
pointer operator-> () const noexcept
unique_ptroperator= (const unique_ptr &)=delete
unique_ptroperator= (nullptr_t) noexcept
unique_ptroperator= (unique_ptr &&)=default
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
std::add_lvalue_reference< element_type >::type operator[] (size_t __i) const
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(*)[] > > > >>
void reset (_Up __p) noexcept
void reset (nullptr_t=nullptr) noexcept
void swap (unique_ptr &__u) noexcept

(Note that these are not member symbols.)

enable_if< __is_swappable< _Dp >::value >::type swap (unique_ptr< _Tp, _Dp > &__x, unique_ptr< _Tp, _Dp > &__y) noexcept
bool operator== (const unique_ptr< _Tp, _Dp > &__x, const unique_ptr< _Up, _Ep > &__y)
bool operator== (const unique_ptr< _Tp, _Dp > &__x, nullptr_t) noexcept
bool operator== (nullptr_t, const unique_ptr< _Tp, _Dp > &__x) noexcept
bool operator!= (const unique_ptr< _Tp, _Dp > &__x, const unique_ptr< _Up, _Ep > &__y)
bool operator!= (const unique_ptr< _Tp, _Dp > &__x, nullptr_t) noexcept
bool operator!= (nullptr_t, const unique_ptr< _Tp, _Dp > &__x) noexcept
bool operator< (const unique_ptr< _Tp, _Dp > &__x, const unique_ptr< _Up, _Ep > &__y)
bool operator< (const unique_ptr< _Tp, _Dp > &__x, nullptr_t)
bool operator< (nullptr_t, const unique_ptr< _Tp, _Dp > &__x)
bool operator<= (const unique_ptr< _Tp, _Dp > &__x, const unique_ptr< _Up, _Ep > &__y)
bool operator<= (const unique_ptr< _Tp, _Dp > &__x, nullptr_t)
bool operator<= (nullptr_t, const unique_ptr< _Tp, _Dp > &__x)
bool operator> (const unique_ptr< _Tp, _Dp > &__x, const unique_ptr< _Up, _Ep > &__y)
bool operator> (const unique_ptr< _Tp, _Dp > &__x, nullptr_t)
bool operator> (nullptr_t, const unique_ptr< _Tp, _Dp > &__x)
bool operator>= (const unique_ptr< _Tp, _Dp > &__x, const unique_ptr< _Up, _Ep > &__y)
bool operator>= (const unique_ptr< _Tp, _Dp > &__x, nullptr_t)
bool operator>= (nullptr_t, const unique_ptr< _Tp, _Dp > &__x)
_MakeUniq< _Tp >::__single_object make_unique (_Args &&... __args)
_MakeUniq< _Tp >::__array make_unique (size_t __num)
_MakeUniq< _Tp >::__invalid_type make_unique (_Args &&...)=delete

Detailed Description

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

20.7.1.3 unique_ptr for array objects with a runtime length

Definition at line 477 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 513 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 504 of file unique_ptr.h.

◆ deleter_type

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

Definition at line 496 of file unique_ptr.h.

◆ element_type

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

Definition at line 495 of file unique_ptr.h.

◆ pointer

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

Definition at line 494 of file unique_ptr.h.

Constructor & Destructor Documentation

◆ unique_ptr() [1/8]

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 529 of file unique_ptr.h.

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

◆ unique_ptr() [2/8]

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

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 546 of file unique_ptr.h.

◆ unique_ptr() [3/8]

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

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 561 of file unique_ptr.h.

◆ unique_ptr() [4/8]

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

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 575 of file unique_ptr.h.

References std::move().

◆ unique_ptr() [5/8]

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/8]

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 593 of file unique_ptr.h.

◆ unique_ptr() [7/8]

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

Definition at line 602 of file unique_ptr.h.

◆ ~unique_ptr()

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 607 of file unique_ptr.h.

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

◆ unique_ptr() [8/8]

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

Definition at line 328 of file auto_ptr.h.

Member Function Documentation

◆ get()

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

Return the stored pointer.

Definition at line 664 of file unique_ptr.h.

◆ get_deleter() [1/2]

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

Return a reference to the stored deleter.

Definition at line 674 of file unique_ptr.h.

◆ get_deleter() [2/2]

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

Return a reference to the stored deleter.

Definition at line 669 of file unique_ptr.h.

◆ operator bool()

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

Return true if the stored pointer is not null.

Definition at line 678 of file unique_ptr.h.

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

◆ operator*()

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

Dereference the stored pointer.

Definition at line 405 of file unique_ptr.h.

◆ operator->()

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

Return the stored pointer.

Definition at line 413 of file unique_ptr.h.

◆ operator=() [1/3]

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

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

Definition at line 646 of file unique_ptr.h.

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

◆ operator=() [2/3]

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().

◆ operator=() [3/3]

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

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 637 of file unique_ptr.h.

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

◆ operator[]()

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

Access an element of owned array.

Definition at line 656 of file unique_ptr.h.

References std::unique_ptr< _Tp, _Dp >::get(), and operator[]().

Referenced by operator[]().

◆ release()

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

Release ownership of any stored pointer.

Definition at line 685 of file unique_ptr.h.

◆ reset() [1/2]

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

Replace the stored pointer.

Parameters
__pThe new pointer to store.

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

Definition at line 707 of file unique_ptr.h.

References std::move().

◆ reset() [2/2]

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

Definition at line 710 of file unique_ptr.h.

◆ swap()

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

Exchange the pointer and deleter with another object.

Definition at line 715 of file unique_ptr.h.

References unique_ptr().

◆ make_unique() [1/3]

_MakeUniq< _Tp >::__single_object make_unique ( _Args &&... __args)
related

std::make_unique for single objects

Definition at line 961 of file unique_ptr.h.

◆ make_unique() [2/3]

_MakeUniq< _Tp >::__invalid_type make_unique ( _Args && ...)
related

Disable std::make_unique for arrays of known bound.

◆ make_unique() [3/3]

_MakeUniq< _Tp >::__array make_unique ( size_t __num)
related

std::make_unique for arrays of unknown bound

Definition at line 967 of file unique_ptr.h.

◆ operator!=() [1/3]

bool operator!= ( const unique_ptr< _Tp, _Dp > & __x,
const unique_ptr< _Up, _Ep > & __y )
related

Inequality operator for unique_ptr objects, compares the owned pointers.

Definition at line 774 of file unique_ptr.h.

◆ operator!=() [2/3]

bool operator!= ( const unique_ptr< _Tp, _Dp > & __x,
nullptr_t  )
related

unique_ptr comparison with nullptr

Definition at line 781 of file unique_ptr.h.

◆ operator!=() [3/3]

bool operator!= ( nullptr_t ,
const unique_ptr< _Tp, _Dp > & __x )
related

unique_ptr comparison with nullptr

Definition at line 787 of file unique_ptr.h.

◆ operator<() [1/3]

bool operator< ( const unique_ptr< _Tp, _Dp > & __x,
const unique_ptr< _Up, _Ep > & __y )
related

Relational operator for unique_ptr objects, compares the owned pointers.

Definition at line 794 of file unique_ptr.h.

◆ operator<() [2/3]

bool operator< ( const unique_ptr< _Tp, _Dp > & __x,
nullptr_t  )
related

unique_ptr comparison with nullptr

Definition at line 806 of file unique_ptr.h.

◆ operator<() [3/3]

bool operator< ( nullptr_t ,
const unique_ptr< _Tp, _Dp > & __x )
related

unique_ptr comparison with nullptr

Definition at line 815 of file unique_ptr.h.

◆ operator<=() [1/3]

bool operator<= ( const unique_ptr< _Tp, _Dp > & __x,
const unique_ptr< _Up, _Ep > & __y )
related

Relational operator for unique_ptr objects, compares the owned pointers.

Definition at line 825 of file unique_ptr.h.

◆ operator<=() [2/3]

bool operator<= ( const unique_ptr< _Tp, _Dp > & __x,
nullptr_t  )
related

unique_ptr comparison with nullptr

Definition at line 832 of file unique_ptr.h.

◆ operator<=() [3/3]

bool operator<= ( nullptr_t ,
const unique_ptr< _Tp, _Dp > & __x )
related

unique_ptr comparison with nullptr

Definition at line 838 of file unique_ptr.h.

◆ operator==() [1/3]

bool operator== ( const unique_ptr< _Tp, _Dp > & __x,
const unique_ptr< _Up, _Ep > & __y )
related

Equality operator for unique_ptr objects, compares the owned pointers.

Definition at line 753 of file unique_ptr.h.

◆ operator==() [2/3]

bool operator== ( const unique_ptr< _Tp, _Dp > & __x,
nullptr_t  )
related

unique_ptr comparison with nullptr

Definition at line 760 of file unique_ptr.h.

◆ operator==() [3/3]

bool operator== ( nullptr_t ,
const unique_ptr< _Tp, _Dp > & __x )
related

unique_ptr comparison with nullptr

Definition at line 767 of file unique_ptr.h.

◆ operator>() [1/3]

bool operator> ( const unique_ptr< _Tp, _Dp > & __x,
const unique_ptr< _Up, _Ep > & __y )
related

Relational operator for unique_ptr objects, compares the owned pointers.

Definition at line 846 of file unique_ptr.h.

◆ operator>() [2/3]

bool operator> ( const unique_ptr< _Tp, _Dp > & __x,
nullptr_t  )
related

unique_ptr comparison with nullptr

Definition at line 853 of file unique_ptr.h.

◆ operator>() [3/3]

bool operator> ( nullptr_t ,
const unique_ptr< _Tp, _Dp > & __x )
related

unique_ptr comparison with nullptr

Definition at line 862 of file unique_ptr.h.

◆ operator>=() [1/3]

bool operator>= ( const unique_ptr< _Tp, _Dp > & __x,
const unique_ptr< _Up, _Ep > & __y )
related

Relational operator for unique_ptr objects, compares the owned pointers.

Definition at line 872 of file unique_ptr.h.

◆ operator>=() [2/3]

bool operator>= ( const unique_ptr< _Tp, _Dp > & __x,
nullptr_t  )
related

unique_ptr comparison with nullptr

Definition at line 879 of file unique_ptr.h.

◆ operator>=() [3/3]

bool operator>= ( nullptr_t ,
const unique_ptr< _Tp, _Dp > & __x )
related

unique_ptr comparison with nullptr

Definition at line 885 of file unique_ptr.h.

◆ swap()

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 738 of file unique_ptr.h.


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