std::inout_ptr

Определён в заголовочном файле `<memory>`
template< class Pointer = void, class Smart, class... Args > auto inout_ptr( Smart& s, Args&&... args );		(since C++23) (constexpr since C++26)

Возвращает inout_ptr_t с выведенными аргументами шаблона, который захватывает аргументы для сброса по ссылке.

Если создание возвращаемого значения (см. ниже) некорректно, программа некорректна.

Параметры

s	-	объект (обычно интеллектуальный указатель), который требуется адаптировать
args	-	аргументы для сброса, которые требуется захватить

Возвращаемое значение

std::inout_ptr_t<Smart, P, Args&&>(s, std::forward<Args>(args)...), где P — это

Pointer, если Pointer не совпадает с void, иначе,
Smart::pointer, если этот тип корректен и обозначает тип, иначе,
Smart::element_type*, если Smart::element_type корректен и обозначает тип, иначе,
std::pointer_traits<Smart>::element_type*.

Примечания

Чтобы обеспечить взаимодействие с внешними функциями, принимающими Pointer*, пользователи могут указать аргумент шаблона для параметра шаблона Pointer.

Поскольку все аргументы для сброса захватываются по ссылке, возвращаемый inout_ptr_t должен быть временным объектом, уничтожаемым в конце полного выражения, содержащего вызов внешней функции, чтобы избежать висячих ссылок.

Макрос проверки поддержки	Значение	Стандарт	Возможность
`__cpp_lib_out_ptr`	`202106L`	(C++23)	`std::out_ptr`, `std::inout_ptr`
`__cpp_lib_out_ptr`	`202311L`	(C++26)	Автономные `std::out_ptr` и `std::inout_ptr`
`__cpp_lib_constexpr_memory`	`202506L`	(C++26)	Константные выражения для `std::inout_ptr`

Пример

См. также

out_ptr (C++23)	создаёт `out_ptr_t`, связанный с интеллектуальным указателем и аргументами для сброса (шаблон функции)
make_uniquemake_unique_for_overwrite (C++14)(C++20)	создаёт уникальный указатель, управляющий новым объектом (шаблон функции)
make_sharedmake_shared_for_overwrite (C++20)	создаёт разделяемый указатель, управляющий новым объектом (шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/memory/inout_ptr_t/inout_ptr