Represent as - История изменений

Андрей Чусов в 11:07, 15 августа 2019

2019-08-15T11:07:54Z

← Предыдущая		Версия 21:07, 15 августа 2019
Строка 1:		Строка 1:
	{{DISPLAYTITLE:represent_as}}		{{DISPLAYTITLE:represent_as}}
	{{function_begin \|template <class ~~_To~~, class ~~_From~~>		{{function_begin \|template <class TargetType, class SourceType>
	auto represent_as(~~_From~~ ref) -> /См. описание./;\|{{represent_as brief}}}}		auto represent_as(SourceType ref) -> /См. описание./;\|{{represent_as brief}}}}
	{{function template paramlist begin}}		{{function template paramlist begin}}
	{{function template paramlist add\|~~_To~~\|Задает тип интерфейса, в который должно быть осуществлено преобразование либо тип [[~~Адаптер программного интерфейса~~\|адаптера с владением]] над таким интерфейсом. Для интерфейса, в который осуществляется преобразование должна быть определена специализация шаблона [[interface_id]].}}		{{function template paramlist add\|TargetType\|Задает тип интерфейса, в который должно быть осуществлено преобразование, либо тип [[владеющий адаптер\|адаптера с владением]] над таким интерфейсом. Для интерфейса, в который осуществляется преобразование должна быть определена специализация шаблона [[interface_id]].}}
	{{function template paramlist add\|~~_From~~\|Тип указателя на интерфейс, над которым осуществляется преобразование, либо тип {{cpp_language\|value_category\|xvalue}}-ссылки на [[~~Адаптер программного интерфейса\|~~ссылочный адаптер]] ~~(без владения)~~ над таким интерфейсом либо {{cpp_language\|value_category\|glvalue}}-ссылка на смарт-указатель [[unique_interface_ptr]] на такой интерфейс. Интерфейс, из которого осуществляется преобразование, должен поддерживать метод <tt>RepresentAs</tt>, принимающий на вход идентификатор интерфейса, соответствующего <tt>~~_To~~</tt>, а также указатель типа <source lang="cpp" inline>void**</source>, и возвращаеть код [[return_code_t]], при успешности которого в выходной указатель должен записываться адрес реализации интерфейса, соответствующего <tt>~~_To~~</tt>, и <source lang="cpp" inline>nullptr</source> - при ошибочности. Тип <tt>~~_From~~</tt> вычисляется дедукцией параметра <tt>ref</tt>.}}		{{function template paramlist add\|SourceType\|Тип указателя на интерфейс, над которым осуществляется преобразование, либо тип {{cpp_language\|value_category\|xvalue}}-ссылки на [[ссылочный адаптер]] над таким интерфейсом либо {{cpp_language\|value_category\|glvalue}}-ссылка на смарт-указатель [[unique_interface_ptr]] на такой интерфейс. Интерфейс, из которого осуществляется преобразование, должен поддерживать метод <tt>RepresentAs</tt>, принимающий на вход идентификатор интерфейса, соответствующего <tt>TargetType</tt>, а также указатель типа <source lang="cpp" inline>void**</source>, и возвращаеть код [[return_code_t]], при успешности которого в выходной указатель должен записываться адрес реализации интерфейса, соответствующего <tt>TargetType</tt>, и <source lang="cpp" inline>nullptr</source> - при ошибочности. Тип <tt>SourceType</tt> вычисляется дедукцией параметра <tt>ref</tt>.}}
	{{function template paramlist end}}		{{function template paramlist end}}
	{{function paramlist begin}}		{{function paramlist begin}}
	{{function paramlist add\|ref\|(Константный) указатель на интерфейс, для которого <source lang="cpp" inline>is_interface<std::remove_pointer_t<~~_From~~>>::value == true</source>, и который поддерживает метод <tt>RepresentAs</tt>, как указано выше, либо (константная) ссылка на [[unique_interface_ptr]] над таким интерфейсом, либо универсальная ссылка на [[~~Адаптер программного интерфейса\|~~адаптер ~~ссылочного типа~~]].}}		{{function paramlist add\|ref\|(Константный) указатель на интерфейс, для которого <source lang="cpp" inline>is_interface<std::remove_pointer_t<SourceType>>::value == true</source>, и который поддерживает метод <tt>RepresentAs</tt>, как указано выше, либо (константная) ссылка на [[unique_interface_ptr]] над таким интерфейсом (возможно, с квалификатором {{cpp_const}}), либо универсальная ссылка на [[ссылочный адаптер]].}}
	{{function paramlist end}}		{{function paramlist end}}
	{{function_return_value\|Если <tt>ref</tt> - указатель на [[программный интерфейс]] или ссылка на [[unique_interface_ptr]] над таким интерфейсом, то возвращается [[unique_interface_ptr]] над типом <tt>~~_To~~</tt>, в который осуществляется преобразование. Если <tt>ref</tt> - ссылка на [[адаптер программного интерфейса]], то возвращается [[адаптер ~~программного интерфейса\|адаптер с владением~~]], определенный над целевым интерфейсом.}}		{{function_return_value\|Если <tt>ref</tt> - указатель на [[программный интерфейс]] или ссылка на [[unique_interface_ptr]] над таким интерфейсом, то возвращается [[unique_interface_ptr]] над типом <tt>TargetType</tt>, в который осуществляется преобразование. Если <tt>ref</tt> - ссылка на [[адаптер программного интерфейса]], то возвращается [[владеющий адаптер]], определенный над целевым интерфейсом.}}
	{{function exceptionlist begin}}		{{function exceptionlist begin}}
	{{function exceptionlist add\|[https://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_chsv_code_exception_templ.html Chusov::Exceptions::ChsvCodeException]\|Исключение, соответствующее коду ошибочного завершения, функции <tt>RepresentAs</tt> интерфейса <tt>~~_From~~</tt>.}}		{{function exceptionlist add\|[https://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_chsv_code_exception_templ.html Chusov::Exceptions::ChsvCodeException]\|Исключение, соответствующее коду ошибочного завершения, функции <tt>RepresentAs</tt> интерфейса <tt>SourceType</tt>.}}
	{{function exceptionlist end}}		{{function exceptionlist end}}
	{{function_end}}		{{function_end}}

	Шаблон функции [[represent_as]] определен, только если требования, указанные для типов <tt>~~_To~~</tt> и <tt>~~_From~~</tt> удовлетворены.		Шаблон функции [[represent_as]] определен, только если требования, указанные для типов <tt>TargetType</tt> и <tt>SourceType</tt> удовлетворены.

	{{example_begin}}		{{example_begin}}
	<source lang="cpp">		<source lang="cpp">

Андрей Чусов в 12:29, 2 января 2018

2018-01-02T12:29:06Z

← Предыдущая		Версия 22:29, 2 января 2018
Строка 4:		Строка 4:
	{{function template paramlist begin}}		{{function template paramlist begin}}
	{{function template paramlist add\|_To\|Задает тип интерфейса, в который должно быть осуществлено преобразование либо тип [[Адаптер программного интерфейса\|адаптера с владением]] над таким интерфейсом. Для интерфейса, в который осуществляется преобразование должна быть определена специализация шаблона [[interface_id]].}}		{{function template paramlist add\|_To\|Задает тип интерфейса, в который должно быть осуществлено преобразование либо тип [[Адаптер программного интерфейса\|адаптера с владением]] над таким интерфейсом. Для интерфейса, в который осуществляется преобразование должна быть определена специализация шаблона [[interface_id]].}}
	{{function template paramlist add\|_From\|Тип указателя на интерфейс, над которым осуществляется преобразование, либо тип {{cpp_language\|~~value_categories~~\|xvalue}}-ссылки на [[Адаптер программного интерфейса\|ссылочный адаптер]] (без владения) над таким интерфейсом либо {{cpp_language\|~~value_categories~~\|glvalue}}-ссылка на смарт-указатель [[unique_interface_ptr]] на такой интерфейс. Интерфейс, из которого осуществляется преобразование, должен поддерживать метод <tt>RepresentAs</tt>, принимающий на вход идентификатор интерфейса, соответствующего <tt>_To</tt>, а также указатель типа <source lang="cpp" inline>void**</source>, и возвращаеть код [[return_code_t]], при успешности которого в выходной указатель должен записываться адрес реализации интерфейса, соответствующего <tt>_To</tt>, и <source lang="cpp" inline>nullptr</source> - при ошибочности. Тип <tt>_From</tt> вычисляется дедукцией параметра <tt>ref</tt>.}}		{{function template paramlist add\|_From\|Тип указателя на интерфейс, над которым осуществляется преобразование, либо тип {{cpp_language\|value_category\|xvalue}}-ссылки на [[Адаптер программного интерфейса\|ссылочный адаптер]] (без владения) над таким интерфейсом либо {{cpp_language\|value_category\|glvalue}}-ссылка на смарт-указатель [[unique_interface_ptr]] на такой интерфейс. Интерфейс, из которого осуществляется преобразование, должен поддерживать метод <tt>RepresentAs</tt>, принимающий на вход идентификатор интерфейса, соответствующего <tt>_To</tt>, а также указатель типа <source lang="cpp" inline>void**</source>, и возвращаеть код [[return_code_t]], при успешности которого в выходной указатель должен записываться адрес реализации интерфейса, соответствующего <tt>_To</tt>, и <source lang="cpp" inline>nullptr</source> - при ошибочности. Тип <tt>_From</tt> вычисляется дедукцией параметра <tt>ref</tt>.}}
	{{function template paramlist end}}		{{function template paramlist end}}
	{{function paramlist begin}}		{{function paramlist begin}}

Андрей Чусов: Новая страница: «{{DISPLAYTITLE:represent_as}} {{function_begin |template auto represent_as(_From ref) -> /См. описание./;|{{represent_as brie…»

2017-12-24T14:23:51Z

Новая страница: «{{DISPLAYTITLE:represent_as}} {{function_begin |template <class _To, class _From> auto represent_as(_From ref) -> См. описание.: ;|{{represent_as brie…»

Новая страница

{{DISPLAYTITLE:represent_as}}
{{function_begin |template <class _To, class _From>
auto represent_as(_From ref) -> /*См. описание.*/;|{{represent_as brief}}}}
{{function template paramlist begin}}
{{function template paramlist add|_To|Задает тип интерфейса, в который должно быть осуществлено преобразование либо тип [[Адаптер программного интерфейса|адаптера с владением]] над таким интерфейсом. Для интерфейса, в который осуществляется преобразование должна быть определена специализация шаблона [[interface_id]].}}
{{function template paramlist add|_From|Тип указателя на интерфейс, над которым осуществляется преобразование, либо тип {{cpp_language|value_categories|xvalue}}-ссылки на [[Адаптер программного интерфейса|ссылочный адаптер]] (без владения) над таким интерфейсом либо {{cpp_language|value_categories|glvalue}}-ссылка на смарт-указатель [[unique_interface_ptr]] на такой интерфейс. Интерфейс, из которого осуществляется преобразование, должен поддерживать метод <tt>RepresentAs</tt>, принимающий на вход идентификатор интерфейса, соответствующего <tt>_To</tt>, а также указатель типа <source lang="cpp" inline>void**</source>, и возвращаеть код [[return_code_t]], при успешности которого в выходной указатель должен записываться адрес реализации интерфейса, соответствующего <tt>_To</tt>, и <source lang="cpp" inline>nullptr</source> - при ошибочности. Тип <tt>_From</tt> вычисляется дедукцией параметра <tt>ref</tt>.}}
{{function template paramlist end}}
{{function paramlist begin}}
{{function paramlist add|ref|(Константный) указатель на интерфейс, для которого <source lang="cpp" inline>is_interface<std::remove_pointer_t<_From>>::value == true</source>, и который поддерживает метод <tt>RepresentAs</tt>, как указано выше, либо (константная) ссылка на [[unique_interface_ptr]] над таким интерфейсом, либо универсальная ссылка на [[Адаптер программного интерфейса|адаптер ссылочного типа]].}}
{{function paramlist end}}
{{function_return_value|Если <tt>ref</tt> - указатель на [[программный интерфейс]] или ссылка на [[unique_interface_ptr]] над таким интерфейсом, то возвращается [[unique_interface_ptr]] над типом <tt>_To</tt>, в который осуществляется преобразование. Если <tt>ref</tt> - ссылка на [[адаптер программного интерфейса]], то возвращается [[адаптер программного интерфейса|адаптер с владением]], определенный над целевым интерфейсом.}}
{{function exceptionlist begin}}
{{function exceptionlist add|[https://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_chsv_code_exception_templ.html Chusov::Exceptions::ChsvCodeException]|Исключение, соответствующее коду ошибочного завершения, функции <tt>RepresentAs</tt> интерфейса <tt>_From</tt>.}}
{{function exceptionlist end}}
{{function_end}}

Шаблон функции [[represent_as]] определен, только если требования, указанные для типов <tt>_To</tt> и <tt>_From</tt> удовлетворены.

{{example_begin}}
<source lang="cpp">
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)));
</source>
{{example_end}}

Represent as - История изменений

Андрей Чусов в 11:07, 15 августа 2019

Андрей Чусов в 12:29, 2 января 2018

Андрей Чусов: Новая страница: «{{DISPLAYTITLE:represent_as}} {{function_begin |template auto represent_as(_From ref) -> /*См. описание.*/;|{{represent_as brie…»

Андрей Чусов: Новая страница: «{{DISPLAYTITLE:represent_as}} {{function_begin |template auto represent_as(_From ref) -> /См. описание./;|{{represent_as brie…»