Spec-Zone.ru › C++

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

explicit out_ptr_t( Smart& sp, Args... args );
(1) (since C++23)
(constexpr since C++26)
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 evaluates sp.reset() if the expression is well-formed; otherwise, evaluates sp = Smart() if std::is_default_constructible_v<Smart> is true. If both resetting operations are ill-formed, the program is 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

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/cpp/memory/out_ptr_t/out_ptr_t

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API