std::out_ptr_t<Smart,Pointer,Args...>:: out_ptr_t

From cppreference.com
C++
Utilities library
General utilities
Relational operators (deprecated in C++20)
Dynamic memory management
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Allocators
Garbage collection support
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)



std::out_ptr_t
explicit out_ptr_t ( Smart & sp, Args... args ) ;
(1) (since C++23)
out_ptr_t ( const out_ptr_t & ) = delete ;
(2) (since C++23)
1) Creates an out_ptr_t . Adapts sp as if binds it to the Smart & member, captures every argument t in args... as if initializes the corresponding member of type T in Args... with std:: forward < T > ( t ) , then value-initializes the stored Pointer .
Then calls sp. reset ( ) if the expression is well-formed; otherwise, calls sp = Smart ( ) if std:: is_default_constructible_v < Smart > is true . The program is ill-formed if both resetting operations are ill-formed.
2) Copy constructor is explicitly deleted. out_ptr_t is neither copyable nor movable.

Parameters

sp - the object (typically a smart pointer) to adapt
args... - the arguments used for resetting to capture

Return value

(none)

Exceptions

May throw implementation-defined exceptions.

Notes

After construction, the Pointer or void * object pointed by the return value of either conversion function is equal to nullptr .

Every argument in args... is moved into the created out_ptr_t if it is of an object type, or transferred into the created out_ptr_t as-is if it is of a reference type.

The constructor of out_ptr_t is allowed to throw exceptions. For example, when sp is a std::shared_ptr , the allocation for the new control block may be performed within the constructor rather than the destructor.

Example

This section is incomplete
Reason: no example
Retrieved from " https://en.cppreference.com/mwiki/index.php?title=cpp/memory/out_ptr_t/out_ptr_t&oldid=162795 "