InternetConnectionOutputByteStreamOwn::InternetConnectionOutputByteStreamOwn

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
InternetConnectionOutputByteStreamOwn() noexcept; //1
explicit InternetConnectionOutputByteStreamOwn(IInternetConnectionOutputByteStream* pStream) noexcept; //2
InternetConnectionOutputByteStreamOwn(InternetConnectionOutputByteStreamOwn&& right) noexcept; //3
template <class AnotherAdapterRef>
explicit InternetConnectionOutputByteStreamOwn(const AnotherAdapterRef& refRight) noexcept; //4
template <class AnotherAdapterOwn>
InternetConnectionOutputByteStreamOwn(const AnotherAdapterOwn& ownRight) noexcept; //5
template <class AnotherAdapterOwn>
InternetConnectionOutputByteStreamOwn(AnotherAdapterOwn&& ownRight) noexcept; //6

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

  1. Конструктор по умолчанию, инициализирующий создаваемый экземпляр адаптера нулевым адресом.
  2. Явный конструктор, инициализирующий создаваемый экземпляр адаптера адресом реализации потока.
  3. Конструктор, выполняющий инициализацию адаптера с перемещением адаптируемой реализации интерфейса. Адаптер right в результате операции теряет владение реализацией потока, как если бы был выполнен вызов right.release_ownership() с присваиванием возвращенного адреса создаваемому адаптеру.
  4. Явный конструктор, создающий адаптер с адресом реализации интерфейса, полученным из ссылочного адаптера refRight путем вызова refRight.get_interface()->Clone() с неявным приведением результата к типу IInternetConnectionOutputByteStream*. Данный конструктор участвует в разрешении перегрузки, только если подтип AnotherAdapterRef::interface_type существует и поддерживает метод AnotherAdapterRef::interface_type::Clone(), указатель AnotherAdapterRef::interface_type* приводим неявно к типу IInternetConnectionOutputByteStream*, а сам тип AnotherAdapterRef является ссылочным адаптером.
  5. Конструктор, создающий экземпляр адаптера на основе заданного параметрически владеющего адаптера путем клонирования интерфейса (то есть вызова метода ownRight.get_interface()->Clone()). Данный конструктор участвует в разрешении перегрузки, только если подтип AnotherAdapterOwn::interface_type существует и поддерживает метод AnotherAdapterOwn::interface_type::Clone(), указатель AnotherAdapterOwn::interface_type* приводим неявно к типу IInternetConnectionOutputByteStream*, а сам тип AnotherAdapterOwn является адаптером с владением.
  6. Конструктор, создающий экземпляр адаптера путем переноса адреса реализации интерфейса AnotherAdapterOwn::interface_type с приведением его к типу IInternetConnectionOutputByteStream*. В результате вызова адаптер ownRight теряет владение своим экземпляром реализации интерфейса AnotherAdapterOwn::interface_type и инициализируется нулевым адресом, как если бы был выполнен вызов ownRight.release_ownership().
Параметры шаблона
AnotherAdapterRefТип ссылочного адаптера, участвующего в качестве параметра refRight в конструкторе 4. Значение std::is_convertible_v<typename AnotherAdapterRef::interface_type*, IInternetConnectionOutputByteStream*> должно быть true, адаптер - ссылочным, а интерфейс AnotherAdapterRef::interface_type должен поддерживать вызов pI->Clone(&pCopy), где pI - указатель оригинальную реализацию интерфейса AnotherAdapterRef::interface_type, pCopy - указатель, на выходе функции Clone принимающий адрес копии оригинальной реализации.
AnotherAdapterOwnТип адаптера с владением, участвующего в качестве параметра ownRight в конструкторах 5 и 6. Значение std::is_convertible_v<typename AnotherAdapterOwn::interface_type*, IInternetConnectionOutputByteStream*> должно быть true, адаптер - владеющим. Для копирования перегрузкой 5 интерфейс AnotherAdapterOwn::interface_type также должен поддерживать вызов pI->Clone(&pCopy), где pI - указатель оригинальную реализацию интерфейса AnotherAdapterRef::interface_type, pCopy - указатель, на выходе функции Clone принимающий адрес копии оригинальной реализации.
Параметры
[in]pStreamУказатель на адаптируемую реализацию потока IInternetConnectionOutputByteStream.
rightАдаптер, передающий владение своим интерфейсным указателем, если он есть, создаваемому экземпляру InternetConnectionOutputByteStreamOwn, как если бы был выполнен вызов right.release_ownership().
refRightСсылочный адаптер, реализация интерфейса которого клонируется с целью создания копии, управляемой создаваемым адаптером, как если бы было выполнено создание адаптера путем вызова перегрузки 2 с аргументом pCopy, получаемым в результате вызова refRight.get_interface()->Clone(&pCopy).
ownRightВладеющий адаптер, реализация интерфейса которого клонируется или переносится на создаваемый адаптер. Копирование выполняется перегрузкой 5, как если бы было выполнено создание адаптера путем вызова перегрузки 2 с аргументом pCopy, получаемым в результате вызова ownRight.get_interface()->Clone(&pCopy). Перемещение выполняется перегрузкой 6, как если бы было выполнено создание адаптера путем вызова перегрузки 2 с аргументом ownRight.release_ownership().