StreamOwn::StreamOwn

StreamOwn(); //1
explicit StreamOwn(IStream* pStream) noexcept; //2
StreamOwn(StreamOwn&& right) noexcept; //3
template <class AnotherAdapterRef>
explicit StreamOwn(const AnotherAdapterRef& refRight) noexcept; //4
template <class AnotherAdapterOwn>
StreamOwn(const AnotherAdapterOwn& ownRight) noexcept; //5
template <class AnotherAdapterOwn>
StreamOwn(AnotherAdapterOwn&& ownRight) noexcept; //6

Конструкторы адаптера с владением.

1. Конструктор по умолчанию, инициализирующий создаваемый экземпляр адаптера нулевым адресом.
2. Явный конструктор, инициализирующий создаваемый экземпляр адаптера адресом реализации потока.
3. Конструктор, выполняющий инициализацию адаптера с перемещением адаптируемой реализации интерфейса. Адаптер right в результате операции теряет владение реализацией потока, как если бы был выполнен вызов right.release_ownership() с присваиванием возвращенного адреса создаваемому адаптеру.
4. Явный конструктор, создающий адаптер с адресом реализации интерфейса, полученным из ссылочного адаптера refRight путем вызова refRight.get_interface()->Clone() с неявным приведением результата к типу IStream*. Данный конструктор участвует в разрешении перегрузки, только если подтип AnotherAdapterRef::interface_type существует и поддерживает метод AnotherAdapterRef::interface_type::Clone(), указатель AnotherAdapterRef::interface_type* приводим неявно к типу IStream*, а сам тип AnotherAdapterRef является ссылочным адаптером.
5. Конструктор, создающий экземпляр адаптера на основе заданного параметром адаптера с владением путем клонирования интерфейса (то есть вызова метода ownRight.get_interface()->Clone()). Данный конструктор участвует в разрешении перегрузки, только если подтип AnotherAdapterOwn::interface_type существует и поддерживает метод AnotherAdapterOwn::interface_type::Clone(), указатель AnotherAdapterOwn::interface_type* приводим неявно к типу IStream*, а сам тип AnotherAdapterOwn является адаптером с владением.
6. Конструктор, создающий экземпляр адаптера путем переноса адреса реализации интерфейса AnotherAdapterOwn::interface_type с приведением его к типу IStream*. В результате вызова адаптер ownRight теряет владение своим экземпляром реализации интерфейса AnotherAdapterOwn::interface_type и инициализируется нулевым адресом, как если бы был выполнен вызов ownRight.release_ownership().

Параметры шаблона

AnotherAdapterRef	Тип ссылочного адаптера, участвующего в качестве параметра refRight в конструкторе 4. Значение std::is_convertible_v<typename AnotherAdapterRef::interface_type*, IStream*> должно быть true, адаптер - ссылочным, а интерфейс AnotherAdapterRef::interface_type должен поддерживать вызов pI->Clone(), где pI - указатель типа AnotherAdapterRef::interface_type*.
AnotherAdapterOwn	Тип адаптера с владением, участвующего в качестве параметра ownRight в конструкторах 5 и 6. Значение std::is_convertible_v<typename AnotherAdapterOwn::interface_type*, IStream*> должно быть true, адаптер - владеющим. Для копирования перегрузкой 5 интерфейс AnotherAdapterOwn::interface_type также должен поддерживать вызов pI->Clone(), где pI - указатель типа AnotherAdapterOwn::interface_type*.

Параметры

[in]	pStream	Указатель на адаптируемую реализацию потока IStream.
	right	Адаптер, передающий владение своим интерфейсным указателем, если он есть, создаваемому экземпляру StreamOwn, как если бы был выполнен вызов right.release_ownership().
	refRight	Ссылочный адаптер, реализация интерфейса которого клонируется с целью создания копии, управляемой создаваемым адаптером, как если бы был выполнено создание адаптера путем вызова перегрузки 2 с аргументом refRight.get_interface()->Clone().
	ownRight	Владеющий адаптер, реализация интерфейса которого клонируется или переносится на создаваемый адаптер. Копирование выполняется перегрузкой 5, как если бы был выполнено создание адаптера путем вызова перегрузки 2 с параметром ownRight.get_interface()->Clone(). Перемещение выполняется перегрузкой 6, как если бы был выполнено создание адаптера путем вызова перегрузки 2 с аргументом ownRight.release_ownership().