http://51.250.0.107/w/index.php?action=history&feed=atom&title=%D0%9E%D0%B1%D1%81%D1%83%D0%B6%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5%3AIGeometryModel%3A%3AMarshal 2026-05-01T13:50:03Z История изменений этой страницы в вики MediaWiki 1.37.1 http://51.250.0.107/w/index.php?title=%D0%9E%D0%B1%D1%81%D1%83%D0%B6%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5:IGeometryModel::Marshal&diff=5137&oldid=prev 2017-08-12T05:19:32Z

<p>Новая страница: «==Старая версия (12.08.17)== {{NavBar|{{Системная иерархия:IGeometryModel}} \ Marshal}} {{function begin|package&lt;default_package_all…»</p> <p><b>Новая страница</b></p><div>==Старая версия (12.08.17)==<br /> <br /> {{NavBar|{{Системная иерархия:IGeometryModel}} \ Marshal}}<br /> {{function begin|package&lt;default_package_allocator, IGeometryModel&gt; Marshal() const;<br /> package_reference&lt;IGeometryModel&gt; Marshal(void* pBuffer, size_type cbBuffer) const;|{{IGeometryModel::Marshal brief}}<br /> # Выделяет память под хранение запакованных данных, которые управляются запаковщиком [[package]].<br /> # Записывает запакованные данные в предоставленный извне буфер.<br /> }}<br /> {{function_paramlist begin}}<br /> {{function_paramlist add|pBuffer|Указатель на буфер памяти, байтовым размером, как минимум, равным значению, возвращаемому методом [[IGeometryModel::MarshalSize]]. Функция заполняет буфер запакованной геометрической моделью.|paramdir=[in]}}<br /> {{function_paramlist add|cbBuffer|Байтовый размер предоставленного для второй перегрузки буфера данных.}}<br /> {{function_paramlist end}}<br /> {{function return_value|<br /> Объект, управляющий запакованным пакетом данных. Первая перегрузка, в отличие от второй, возвращает объект, также управляющий буфером, хранящим запакованные данные, и автоматически освобождает память при деструкции возвращенного объекта. Вторая перегрузка управляет только данными, но ответственность за освобождения памяти буфера ложится на вызывающего.}}<br /> {{function details<br /> |Перегрузка 1 за раз создает смарт объект C++ (см. [[package]]), который управляет как запаковкой, так и выделенной им же памятью. Перегрузка 2 позволяет использовать уже существующую память, которая заполняется запакованной геометрической моделью среды моделируемого поля. В обоих случаях полученный пакет данных полностью описывает геометрическую модель и может быть передан удаленным узлам.<br /> <br /> Вторая перегрузка предполагает, что размер предоставленного буфера задан в байтах параметром &lt;tt&gt;cbBuffer&lt;/tt&gt;. Этот размер должен быть не меньше значения, возвращаемого методом [[IGeometryModel::MarshalSize]].<br /> <br /> Методы фактически делегируют вызов запаковщику [[package]], на вход которого можно предоставлять геометрическую модель напрямую, без вызова методов.<br /> &lt;syntaxhighlight lang=cpp&gt;<br /> using namespace CAMaaS;<br /> <br /> const IGeometryModel&amp; geom = get(); //какой-то метод возвращающий read-only ссылку на модель<br /> <br /> auto pckg = package&lt;std::allocator, IGeometryModel&gt; (geom); //аналогично вызову geom.Marshal();<br /> <br /> auto buffer_size = package_reference&lt;IGeometryModel&gt;::calculate_size(geom); //аналогично geom.MarshalSize();<br /> auto buffer = new std::uint8_t [buffer_size];<br /> auto pckg_ref = package_reference&lt;IGeometryModel&gt; (buffer, buffer_size, geom); //аналогично вызову geom.Marshal(buffer, buffer_size);<br /> &lt;/syntaxhighlight&gt;<br /> }}<br /> {{function_exceptionlist begin}}<br /> {{function_exceptionlist add|[http://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_out_of_memory_exception.html Chusov::Exceptions::OutOfMemoryException]|Исключение, которое может быть сгенерировано перегрузкой 1 в случае нехватки памяти.}}<br /> {{function_exceptionlist add|[http://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_insufficient_buffer_exception.html Chusov::Exceptions::InsufficientBufferException]|Исключение, которое может быть сгенерировано перегрузкой 2 в случае, если предоставлен слишком малый буфер &lt;tt&gt;pBuffer&lt;/tt&gt;.}}<br /> {{function_exceptionlist end}}<br /> {{function_sa begin}}<br /> {{function_sa add|[[package_reference]]}}<br /> {{function_sa add|[[package]]}}<br /> {{function_sa add|[[make_package]]|Функция, позволяющая создание запакованных объектов на основе их типов, полученных дедукцией и с использованием стандартного менеджера памяти [http://en.cppreference.com/w/cpp/memory/allocator std::allocator].}}<br /> {{function_sa end}}<br /> {{function end}}</div>

Андрей Чусов