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

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

2016-01-09T19:36:01Z

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

← Предыдущая	Версия 05:36, 10 января 2016
(нет различий)

Андрей Чусов в 19:35, 9 января 2016

2016-01-09T19:35:38Z

Андрей Чусов: Новая страница: «{{NavBar|{{IPolyObject hierarchy}} \ Marshal}} {{function begin|package Marshal() const; package_reference Ma…»

2016-01-03T17:37:09Z

Новая страница: «{{NavBar|{{IPolyObject hierarchy}} \ Marshal}} {{function begin|package<default_package_allocator, IPolyObject> Marshal() const; package_reference<IPolyObject> Ma…»

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

{{NavBar|{{IPolyObject hierarchy}} \ Marshal}}
{{function begin|package<default_package_allocator, IPolyObject> Marshal() const;
package_reference<IPolyObject> Marshal(void* pBuffer, size_type cbBuffer) const;|{{IPolyObject_Marshal_brief}}
# Выделяет память под хранение запакованных данных, которые управляются запаковщиком [[package]].
# Записывает запакованные данные в предоставленный извне буфер.
}}
{{function_paramlist begin}}
{{function_paramlist add|pBuffer|Указатель на буфер памяти, байтовым размером, как минимум, равным значению, возвращаемому методом [[IPolyObject_MarshalSize|IPolyObject::MarshalSize]]. Функция заполняет буфер запакованным полигональным объектом.|paramdir=[in]}}
{{function_paramlist add|cbBuffer|Байтовый размер предоставленного для второй перегрузки буфера данных.}}
{{function_paramlist end}}
{{function return_value|
Объект, управляющий запакованным пакетом данных. Первая перегрузка, в отличие от второй, возвращает объект, который также управляет буфером, хранящим запакованные данные, и автоматически освобождает память при деструкции возвращенного объекта. Вторая перегрузка управляет только данными, но ответственность за освобождение памяти буфера ложится на вызывающего.}}
{{function details
|Перегрузка 1 создает смарт объект C++ (см. [[package]]), который управляет как запаковкой, так и выделенной им же памятью. Перегрузка 2 позволяет использовать уже существующую память, которая заполняется запакованным полигональным объектом.

Вторая перегрузка предполагает, что размер предоставленного буфера задан в байтах параметром <tt>cbBuffer</tt>. Этот размер должен быть не меньше значения, возвращаемого методом [[IPolyObject_MarshalSize|IPolyObject::MarshalSize]].

Методы фактически делегируют вызов запаковщику [[package]], на вход которого можно предоставлять экземпляр плоскости напрямую, без вызова методов.
<syntaxhighlight lang=cpp>
using namespace CAMaaS;

const IPolyObject& poly = get(); //какой-то метод возвращающий read-only ссылку на модель

auto pckg = package<std::allocator, IPolyObject> (poly); //аналогично вызову poly.Marshal();

auto buffer_size = package_reference<IPolyObject>::calculate_size(poly); //аналогично poly.MarshalSize();
auto buffer = new std::uint8_t [buffer_size];
auto pckg_ref = package_reference<IPolyObject> (buffer, buffer_size, poly); //аналогично вызову poly.Marshal(buffer, buffer_size);
</syntaxhighlight>
}}
{{function_exceptionlist begin}}
{{function_exceptionlist add|[http://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_out_of_memory_exception.html Chusov::Exceptions::OutOfMemoryException]|Исключение, которое может быть сгенерировано перегрузкой 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_reference]]}}
{{function_sa add|[[package]]}}
{{function_sa add|[[make_package]]|Функция, позволяющая создание запакованных объектов на основе их типов, полученных дедукцией и с использованием стандартного менеджера памяти [http://en.cppreference.com/w/cpp/memory/allocator std::allocator].}}
{{function_sa end}}
{{function end}}

← Предыдущая		Версия 05:35, 10 января 2016
Строка 1:		Строка 1:
	{{NavBar\|{{IPolyObject ~~hierarchy~~}} \ Marshal}}		{{NavBar\|{{Системная иерархия:IPolyObject}} \ Marshal}}
	{{function begin\|package<default_package_allocator, IPolyObject> Marshal() const;		{{function begin\|package<default_package_allocator, IPolyObject> Marshal() const;
	package_reference<IPolyObject> Marshal(void* pBuffer, size_type cbBuffer) const;\|{{~~IPolyObject_Marshal_brief~~}}		package_reference<IPolyObject> Marshal(void* pBuffer, size_type cbBuffer) const;\|{{IPolyObject::Marshal brief}}
	# Выделяет память под хранение запакованных данных, которые управляются запаковщиком [[package]].		# Выделяет память под хранение запакованных данных, которые управляются запаковщиком [[package]].
	# Записывает запакованные данные в предоставленный извне буфер.		# Записывает запакованные данные в предоставленный извне буфер.
	}}		}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|pBuffer\|Указатель на буфер памяти, байтовым размером, как минимум, равным значению, возвращаемому методом [[~~IPolyObject_MarshalSize\|~~IPolyObject::MarshalSize]]. Функция заполняет буфер запакованным полигональным объектом.\|paramdir=[in]}}		{{function_paramlist add\|pBuffer\|Указатель на буфер памяти, байтовым размером, как минимум, равным значению, возвращаемому методом [[IPolyObject::MarshalSize]]. Функция заполняет буфер запакованным полигональным объектом.\|paramdir=[in]}}
	{{function_paramlist add\|cbBuffer\|Байтовый размер предоставленного для второй перегрузки буфера данных.}}		{{function_paramlist add\|cbBuffer\|Байтовый размер предоставленного для второй перегрузки буфера данных.}}
	{{function_paramlist end}}		{{function_paramlist end}}
Строка 14:		Строка 14:
	\|Перегрузка 1 создает смарт объект C++ (см. [[package]]), который управляет как запаковкой, так и выделенной им же памятью. Перегрузка 2 позволяет использовать уже существующую память, которая заполняется запакованным полигональным объектом.		\|Перегрузка 1 создает смарт объект C++ (см. [[package]]), который управляет как запаковкой, так и выделенной им же памятью. Перегрузка 2 позволяет использовать уже существующую память, которая заполняется запакованным полигональным объектом.

	Вторая перегрузка предполагает, что размер предоставленного буфера задан в байтах параметром <tt>cbBuffer</tt>. Этот размер должен быть не меньше значения, возвращаемого методом [[~~IPolyObject_MarshalSize\|~~IPolyObject::MarshalSize]].		Вторая перегрузка предполагает, что размер предоставленного буфера задан в байтах параметром <tt>cbBuffer</tt>. Этот размер должен быть не меньше значения, возвращаемого методом [[IPolyObject::MarshalSize]].

	Методы фактически делегируют вызов запаковщику [[package]], на вход которого можно предоставлять экземпляр плоскости напрямую, без вызова методов.		Методы фактически делегируют вызов запаковщику [[package]], на вход которого можно предоставлять экземпляр плоскости напрямую, без вызова методов.