TFACE::Marshal - История изменений

Андрей Чусов: Андрей Чусов переименовал страницу FACE3DEXT Marshal в TFACE::Marshal без оставления перенаправления

2016-01-10T20:55:26Z

Андрей Чусов переименовал страницу FACE3DEXT Marshal в TFACE::Marshal без оставления перенаправления

Андрей Чусов в 20:55, 10 января 2016

2016-01-10T20:55:06Z

Андрей Чусов: Новая страница: «{{NavBar|{{FACE3DEXT hierarchy}} \ Marshal}} {{function begin|template package
2016-01-06T14:10:58Z

Новая страница: «{{NavBar|{{FACE3DEXT hierarchy}} \ Marshal}} {{function begin|template <class packed_alloc_t {{=}} default_package_allocator> package<packed_alloc_t, __TFACE<u…»

Новая страница
{{NavBar|{{FACE3DEXT hierarchy}} \ Marshal}}
{{function begin|template <class packed_alloc_t {{=}} default_package_allocator>
package<packed_alloc_t, __TFACE<unit_t, alloc_t>> Marshal(const packed_alloc_t& packed_alloc {{=}} packed_alloc_t()) const;
package_const_reference<__TFACE<unit_t, alloc_t>> Marshal(void* pBuffer, size_type cbBuffer) const;|{{FACE3DEXT_Marshal_brief}}

#Создает и возвращает запаковщик [[package]], управляющий данными и выделенной им для этих данных памятью.
#Создает и возвращает запаковщик [[package_reference]], управляющий данными, записываемыми в предоставленный извне буфер. Ответственность за управления буфером в данном случае ложится на вызывающего.}}
{{function_paramlist begin}}
{{function_paramlist add|packed_alloc|Менеджер памяти, который должен использоваться объектом [[package]].}}
{{function_paramlist add|pBuffer|Указатель на буфер памяти, который будет использоваться объектом [[package_reference]] для записи в этот буфер запакованного полигона.|paramdir=[in]}}
{{function_paramlist add|cbBuffer|Байтовый размер предоставленного извне буфера, который должен быть не меньше значения, возвращаемого методом [[FACE3DEXT_MarshalSize|FACE3DEXT::MarshalSize]].}}
{{function_paramlist end}}
{{function_return_value|Созданный запаковщик, с ассоциированным запакованным полигоном.}}
{{function_details|Фактически методы делегируют вызовы конструкторам создаваемых и возвращаемых запаковщиков, [[package]] и [[package_reference]] соответственно, которые создают и управляют запакованными данными, и, для перегрузки 1, памятью:
<syntaxhighlight lang="cpp">
template <class packed_alloc_t = default_package_allocator>
package<packed_alloc_t, __TFACE<unit_t, alloc_t>> Marshal(const packed_alloc_t& packed_alloc = packed_alloc_t()) const
{
return package<packed_alloc_t, __TFACE<unit_t, alloc_t>>(std::allocator_arg, packed_alloc, this);
}
package_const_reference<__TFACE<unit_t, alloc_t>> Marshal(_Out_bytecap_(cbBuffer) void pBuffer, size_type cbBuffer) const
{
return package_const_reference<__TFACE<unit_t, alloc_t>>(pBuffer, cbBuffer, *this);
}
</syntaxhighlight>

Вместо вызова данного метода предпочтительнее использовать запаковщик напрямую, либо через вспомогательную функцию [[make_package]].}}
{{function_exceptionlist begin}}
{{function_exceptionlist add||Перегрузка 1 не генерирует исключений, но исключения, сгенерированные менеджером памяти не перехватываются.}}
{{function_exceptionlist add|[http://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_insufficient_buffer_exception.html Chusov::Exceptions::InsufficientBufferException]|Исключение, которое может быть сгенерировано перегрузкой 2 в случае, если предоставлен слишком малый буфер <tt>pBuffer</tt>.}}
{{function_exceptionlist end}}
{{function_sa begin}}
{{function_sa add|[[package]]|Используемый методом запаковщик.}}
{{function_sa add|[[default_package_allocator]]|Используемый запаковщиком менеджер памяти по умолчанию.}}
{{function_sa add|[http://en.cppreference.com/w/cpp/concept/Allocator Allocator]|Требования к пользовательскому менеджеру памяти.}}
{{function_sa end}}
{{function end}}