represent_as

template <class TargetType, class SourceType>
auto represent_as(SourceType ref) -> /*См. описание.*/;

Осуществляет преобразование интерфейса, поддерживающего метод RepresentAs, в другой интерфейс и возвращает unique_interface_ptr-указатель на него или его адаптер с владением.

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

TargetType

Задает тип интерфейса, в который должно быть осуществлено преобразование, либо тип адаптера с владением над таким интерфейсом. Для интерфейса, в который осуществляется преобразование должна быть определена специализация шаблона interface_id.

SourceType

Тип указателя на интерфейс, над которым осуществляется преобразование, либо тип xvalue-ссылки на ссылочный адаптер над таким интерфейсом либо glvalue-ссылка на смарт-указатель unique_interface_ptr на такой интерфейс. Интерфейс, из которого осуществляется преобразование, должен поддерживать метод RepresentAs, принимающий на вход идентификатор интерфейса, соответствующего TargetType, а также указатель типа void**, и возвращаеть код return_code_t, при успешности которого в выходной указатель должен записываться адрес реализации интерфейса, соответствующего TargetType, и nullptr - при ошибочности. Тип SourceType вычисляется дедукцией параметра ref.

Параметры

ref

(Константный) указатель на интерфейс, для которого is_interface<std::remove_pointer_t<SourceType>>::value == true, и который поддерживает метод RepresentAs, как указано выше, либо (константная) ссылка на unique_interface_ptr над таким интерфейсом (возможно, с квалификатором const), либо универсальная ссылка на ссылочный адаптер.

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

Если ref - указатель на программный интерфейс или ссылка на unique_interface_ptr над таким интерфейсом, то возвращается unique_interface_ptr над типом TargetType, в который осуществляется преобразование. Если ref - ссылка на адаптер программного интерфейса, то возвращается владеющий адаптер, определенный над целевым интерфейсом.

Возможные исключения

Chusov::Exceptions::ChsvCodeException

Исключение, соответствующее коду ошибочного завершения, функции RepresentAs интерфейса SourceType.

Шаблон функции represent_as определен, только если требования, указанные для типов TargetType и SourceType удовлетворены.

Пример

ConsequentDataStorageInputOwn ibs = represent_as<InputByteStreamOwn>(represent_as<ConsequentDataStorageInputOwn>(storage).read());
unique_interface_ptr<IConsequentDataStorageInput> *ppDataStorage = represent_as<IConsequentDataStorageInput>(m_domain.get_domain_data(element_name_type(pDomainName, cbDomainName)));