std::out_ptr_t<Smart,Pointer,Args...>::out_ptr_t
|
(1) | (since C++23) |
|
(2) | (since C++23) |
1) Creates an
Then calls
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
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/memory/out_ptr_t/out_ptr_t