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

Андрей Чусов в 09:44, 3 июня 2017

2017-06-03T09:44:55Z

Андрей Чусов: /* Interface providers */

2016-11-19T05:10:20Z

Interface providers

← Предыдущая		Версия 15:10, 19 ноября 2016
Строка 359:		Строка 359:
	to the interface provider to the \p interface_class* pointer type.		to the interface provider to the \p interface_class* pointer type.

	Default (unspecialized) interface provider has empty body providing no extra members other than ones provided by the marshaller.		Default (unspecialized) interface provider has empty body providing no extra members other than ones provided by the marshaller. The default <tt>package_interface_provider<T, interface_class></tt> implementation publicly inherits members from <tt>package_const_interface_provider<T, interface_class></tt>.

	There are members of any marshaller that are mandatory and hence always present in the marshaller definition overriding and hiding members with the same name,		There are members of any marshaller that are mandatory and hence always present in the marshaller definition overriding and hiding members with the same name,

Андрей Чусов: /* Sequence marshallers */

2016-11-16T05:37:14Z

Sequence marshallers

← Предыдущая		Версия 15:37, 16 ноября 2016
Строка 560:		Строка 560:
	by a pair of input iterators and is described by an object of type \ref sequence_to_pack_t<iterator>, where \p iterator is a type of two input iterators specifying		by a pair of input iterators and is described by an object of type \ref sequence_to_pack_t<iterator>, where \p iterator is a type of two input iterators specifying
	an inclusive beginning and and exclusive end of the range of objects to pack.		an inclusive beginning and and exclusive end of the range of objects to pack.

			For any given <tt>T</tt> and <tt>It</tt>, such that a package for <tt>sequence_of<T></tt> type is specified by a sequence <tt>sequence_to_pack_t<It></tt>, the type <source lang='cpp' inline>std::iterator_traits<It>::value_type</source> must be implicitly convertible to <tt>T</tt>.

	Using these three classes the packing can be achieved as follows:		Using these three classes the packing can be achieved as follows:

Андрей Чусов: /* Utility components */

2016-11-11T08:02:34Z

Utility components

@@ Строка 757: / Строка 757: @@
 </source>
-===make_package and mack_const_package===
+===Tuple marshallers===
 The following two functions deduce package type from a specified parameter list.
@@ Строка 781: / Строка 888: @@
 efforts from a user or one who customizes marshallers of each element of the sequence.
-) whether a paked data element can be randomly accessed by a user at a constant time. By default, this is considered true only if a type being packed is scalar, i.e. for which
+) whether a packed data element can be randomly accessed by a user at a constant time. By default, this is considered true only if a type being packed is scalar, i.e. for which
 std::is_scalar<T>::value is true. To improve performance of a marshaller specialized for a custom type \p T, given the latter has a constant size in packed form, an implementer
 of the type \p T has to define either a known nested type \ref random_composition_access_tag which should resolve to \p std::true_type, or externally (relatively

Андрей Чусов: /* Sequence marshallers */

2016-11-11T06:12:48Z

Sequence marshallers

← Предыдущая		Версия 16:12, 11 ноября 2016
Строка 590:		Строка 590:

	sequence_to_pack_t<wchar_t> sequence_to_pack(_In_z_ wchar_t psz);		sequence_to_pack_t<wchar_t> sequence_to_pack(_In_z_ wchar_t psz);

			template <class InputIterator>
			sequence_to_pack_t<InputIterator> sequence_to_pack(InputIterator itBegin, InputIterator itEnd);

	</source>		</source>

Андрей Чусов: /* Methods */

2016-11-11T04:19:28Z

Methods

← Предыдущая		Версия 14:19, 11 ноября 2016
Строка 282:		Строка 282:
	is a function parsing a given package to retrieve its size.		is a function parsing a given package to retrieve its size.

	5) <source lang='cpp' inline>static get_type read(_In_bytecount_(cbBuf) void* pBuf, size_type cbBuf);</source>		5) <source lang='cpp' inline>template <class...constr_params_t> static get_type read(_In_bytecount_(cbBuf) void* pBuf, size_type cbBuf, constr_params_t&&...constr_params);</source>

	is a function reading a specified package to return an unpacked object of type \p get_type		is a function reading a specified package to return an unpacked object of type \p get_type to the user of the corresponding wrapper. <tt>constr_params</tt> are forwarded to the provider via packagers' get methods.
	to the user of the corresponding wrapper.

	6) <source lang='cpp' inline>static const_get_type read(_In_bytecount_(cbBuf) const void* pBuf, size_type cbBuf);</source>		6) <source lang='cpp' inline>template <class...constr_params_t> static const_get_type read(_In_bytecount_(cbBuf) const void* pBuf, size_type cbBuf, constr_params_t&&...constr_params);</source>

	is a similar function returning a constant object of type \p const_get_type		is a similar function returning a constant object of type \p const_get_type to a user of the wrapper.
	to a user of the wrapper.

	Inheriting from the default service provider with redefining chosen functions is allowed.		Inheriting from the default service provider with redefining chosen functions is allowed.
Строка 298:		Строка 296:
	struct I		struct I
	{		{
	virtual int ~~get~~() const = 0;		virtual int getval() const = 0;
	};		};

Строка 305:		Строка 303:
	int x;		int x;
	C(int arg):x(arg) {}		C(int arg):x(arg) {}
	int ~~get~~() const		int getval() const
	{		{
	return x;		return x;
Строка 321:		Строка 319:
	static size_type write(void* pOut, size_type cbOut, const I& obj)		static size_type write(void* pOut, size_type cbOut, const I& obj)
	{		{
	return default_packing_service_provider<int>::write(pOut, cbOut, obj.~~get~~());		return default_packing_service_provider<int>::write(pOut, cbOut, obj.getval());
	}		}
	static get_type read(_In_bytecount_(cbBuf) void* pBuf, size_type cbBuf)		static get_type read(_In_bytecount_(cbBuf) void* pBuf, size_type cbBuf)
Строка 330:		Строка 328:
	{		{
	return get_type(new C(default_packing_service_provider<int>::read(pBuf, cbBuf)));		return get_type(new C(default_packing_service_provider<int>::read(pBuf, cbBuf)));
			}
			static get_type read(_In_bytecount_(cbBuf) void* pBuf, size_type cbBuf, int init)
			{
			return get_type(new C(default_packing_service_provider<int>::read(pBuf, cbBuf) + init));
			}
			static const_get_type read(_In_bytecount_(cbBuf) const void* pBuf, size_type cbBuf, int init)
			{
			return get_type(new C(default_packing_service_provider<int>::read(pBuf, cbBuf) + init));
	}		}
	};		};

			//usage

			#include <iostream>

			int main(int, char**)
			{
			C val = 0;
			auto pckg = CAMaaS::make_package(static_cast<I&>(val));
			std::cout << pckg.get()->getval() << '\n';
			std::cout << pckg.get(1)->getval() << '\n';
			return 0;
			}
	</source>		</source>

Андрей Чусов: /* Types */

2016-11-11T02:41:50Z

Types

← Предыдущая		Версия 12:41, 11 ноября 2016
Строка 249:		Строка 249:

	==Types==		==Types==
	1) value_type is a type to be used as an input for a marshalling method. If the marshaller is specialized for a given type \p T (e.g. package<T>), than T must be		;value_type:is a type to be used as an input for a marshalling method. If the marshaller is specialized for a given type \p T (e.g. package<T>), than T must be implicitly convertible to packing_service_provider<T>::value_type. Typical definition of \p value_type is \p T itself.
	implicitly convertible to packing_service_provider<T>::value_type. Typical definition of \p value_type is \p T itself.		;reference: is a mutable reference to an object being packed.
	2) reference is a mutable reference to an object being packed.		;const_reference: is a constant reference to an object being packed.
	3) const_reference is a constant reference to an object being packed.		;pointer: is a pointer to a mutable object being packed.
	4) pointer is a pointer to a mutable object being packed.		;const_pointer: is a pointer to a constant object being packed.
	5) const_pointer is a pointer to a constant object being packed.		;get_type: is a type of data to be returned to a user of a marshaller when package is being read. The returned data is considered mutable.
	6) get_type is a type of data to be returned to a user of a marshaller when package is being read. The returned data is considered mutable.		;const_get_type: is a type of data to be returned to a user of a marshaller when package is being read. The returned data is considered constant.
	7) const_get_type is a type of data to be returned to a user of a marshaller when package is being read. The returned data is considered constant.		;size_type: is a type of byte size of
	8) size_type is a type of byte size of

	==Methods==		==Methods==

Андрей Чусов: /* package_reference - endptr */

2016-07-26T05:15:35Z

package_reference - endptr

← Предыдущая		Версия 15:15, 26 июля 2016
Строка 93:		Строка 93:
	{		{
	public:		public:
	typedef typename std::common_type<package_reference<T>::size_type...>::type size_type;		typedef typename std::common_type<package_reference<T>::size_type...>::type size_type;
	template <size_type I>		template <size_type I>
	using packed_value_type; /package_reference<T0, T1, ..., Ti, ...>::template packed_value_type<i> resolves into package_reference<Ti>/		using packed_value_type; /package_reference<T0, T1, ..., Ti, ...>::template packed_value_type<i> resolves into package_reference<Ti>/
	template <size_type I>		template <size_type I>
	using packed_type_from; /package_reference<T0, T1, ..., Ti,...>::template packed_value_type<i> resolves into package_reference<Ti...>/		using packed_type_from; /package_reference<T0, T1, ..., Ti,...>::template packed_value_type<i> resolves into package_reference<Ti...>/
	template <size_type I>		template <size_type I>
	using value_type = typename packed_value_type<I>::value_type; /package_reference<T0, T1, ..., Ti,...>::template value_type<i> resolves into typename packing_service_provider<Ti>::value_type/		using value_type = typename packed_value_type<I>::value_type; /package_reference<T0, T1, ..., Ti,...>::template value_type<i> resolves into typename packing_service_provider<Ti>::value_type/
	/which is typename std::remove_cv<typename std::remove_reference<Ti>::type>::type by default/		/which is typename std::remove_cv<typename std::remove_reference<Ti>::type>::type by default/

	template <class...U>		template <class...U>
	static size_type calculate_size(const U&...refs);		static size_type calculate_size(const U&...refs);
	static _Success_(return != false) bool verify_package_size(_In_bytecount_(cbBuf) const void* pBuf, size_type cbBuf, _Out_opt_ size_type* pSize = nullptr);		static _Success_(return != false) bool verify_package_size(_In_bytecount_(cbBuf) const void* pBuf, size_type cbBuf, _Out_opt_ size_type* pSize = nullptr);
	package_reference();		package_reference();
	template <class...U>		template <class...U>
	package_reference(_Out_bytecap_(cbPackedData) void* pPackedData, size_type cbPackedData, _In_ U&&...refs);		package_reference(_Out_bytecap_(cbPackedData) void* pPackedData, size_type cbPackedData, _In_ U&&...refs);
	package_reference(_In_bytecount_(cbPackedData) void* pPackedData, size_type cbPackedData);		package_reference(_In_bytecount_(cbPackedData) void* pPackedData, size_type cbPackedData);
	const void* data();		const void* data() const;
	void* data();		void* data();
	size_type size() const;		const void* endptr() const;
	/specifics/		void* endptr();
	template <size_type packed_pos, class...get_params_t>		size_type size() const;
	typename packed_item<packed_pos, T0, TN...>::packed_item_ref_type::const_get_type get(get_params_t&&...get_params) const;		/specifics/
	template <size_type packed_pos, class...get_params_t>		template <size_type packed_pos, class...get_params_t>
	typename packed_item<packed_pos, T0, TN...>::packed_item_ref_type::get_type get(get_params_t&&...get_params);		typename packed_item<packed_pos, T0, TN...>::packed_item_ref_type::const_get_type get(get_params_t&&...get_params) const;
	template <size_type packed_pos>		template <size_type packed_pos, class...get_params_t>
	typename packed_item<packed_pos, T0, TN...>::const_packed_item_ref_type get_packed_item() const;		typename packed_item<packed_pos, T0, TN...>::packed_item_ref_type::get_type get(get_params_t&&...get_params);
	template <size_type packed_pos>		template <size_type packed_pos>
	typename packed_item<packed_pos, T0, TN...>::packed_item_ref_type get_packed_item();		typename packed_item<packed_pos, T0, TN...>::const_packed_item_ref_type get_packed_item() const;
	template<size_type packed_start_pos>		template <size_type packed_pos>
	typename packed_item<packed_start_pos, T0, TN...>::const_packed_with_rest_ref_type get_packed_items_from() const;		typename packed_item<packed_pos, T0, TN...>::packed_item_ref_type get_packed_item();
	template<size_type packed_start_pos>		template<size_type packed_start_pos>
	typename packed_item<packed_start_pos, T0, TN...>::packed_with_rest_ref_type get_packed_items_from();		typename packed_item<packed_start_pos, T0, TN...>::const_packed_with_rest_ref_type get_packed_items_from() const;
			template<size_type packed_start_pos>
			typename packed_item<packed_start_pos, T0, TN...>::packed_with_rest_ref_type get_packed_items_from();
	};		};

	template <class T>		template <class T>
	class package_reference<T>:		class package_reference<T>:
	private packing_service_provider<typename std::remove_cv<typename std::remove_reference<T>::type>::type>,		private packing_service_provider<typename std::remove_cv<typename std::remove_reference<T>::type>::type>,
	public package_interface_provider<		public package_interface_provider<
	typename std::remove_cv<typename std::remove_reference<T>::type>::type,		typename std::remove_cv<typename std::remove_reference<T>::type>::type,
	package_reference<typename std::remove_cv<typename std::remove_reference<T>::type>::type>		package_reference<typename std::remove_cv<typename std::remove_reference<T>::type>::type>
	>		>
	{		{
	public:		public:
	/The following types are specified by the service provider/		/The following types are specified by the service provider/
	typedef typename sp_t::value_type value_type;		typedef typename sp_t::value_type value_type;
	typedef typename sp_t::reference reference;		typedef typename sp_t::reference reference;
	typedef typename sp_t::const_reference const_reference;		typedef typename sp_t::const_reference const_reference;
	typedef typename sp_t::pointer pointer;		typedef typename sp_t::pointer pointer;
	typedef typename sp_t::const_pointer const_pointer;		typedef typename sp_t::const_pointer const_pointer;
	typedef typename sp_t::const_get_type const_get_type;		typedef typename sp_t::const_get_type const_get_type;
	typedef typename sp_t::get_type get_type;		typedef typename sp_t::get_type get_type;
	typedef typename sp_t::size_type size_type;		typedef typename sp_t::size_type size_type;

	template <class U>		template <class U>
	static size_type calculate_size(U&& ref) {return sp_t::calculate_size(std::forward<U>(ref));}		static size_type calculate_size(U&& ref) {return sp_t::calculate_size(std::forward<U>(ref));}
	static _Success_(return != false) bool verify_package_size(_In_bytecount_(cbBuf) const void* pBuf, size_type cbBuf, _Out_opt_ size_type* pSize = nullptr);		static _Success_(return != false) bool verify_package_size(_In_bytecount_(cbBuf) const void* pBuf, size_type cbBuf, _Out_opt_ size_type* pSize = nullptr);
	package_reference();		package_reference();
	template <class U>		template <class U>
	package_reference(_Out_bytecap_(cbPackedData) void* pPackedData, size_type cbPackedData, _In_ U&& ref);		package_reference(_Out_bytecap_(cbPackedData) void* pPackedData, size_type cbPackedData, _In_ U&& ref);

	package_reference(_In_bytecount_(cbPackedData) void* pPackedData, size_type cbPackedData);		package_reference(_In_bytecount_(cbPackedData) void* pPackedData, size_type cbPackedData);
	const void* data() const;		const void* data() const;
	void* data();		void* data();
	size_type size() const;		const void* endptr() const;
			void* endptr();
			size_type size() const;

	template <class...get_params_t>		template <class...get_params_t>
	const_get_type get(get_params_t&&...get_params) const;		const_get_type get(get_params_t&&...get_params) const;
	template <class...get_params_t>		template <class...get_params_t>
	get_type get(get_params_t&&...get_params);		get_type get(get_params_t&&...get_params);
	};		};
	</source>		</source>

Андрей Чусов: /* package_const_reference - endptr*/

2016-07-26T05:13:14Z

package_const_reference - endptr

← Предыдущая		Версия 15:13, 26 июля 2016
Строка 37:		Строка 37:
	package_const_reference(const package_reference<T0, TN...>& refRight);		package_const_reference(const package_reference<T0, TN...>& refRight);
	const void* data() const;		const void* data() const;
			const void* endptr() const;
	size_type size() const;		size_type size() const;

Строка 51:		Строка 52:
	template <class T>		template <class T>
	class package_const_reference<T>:		class package_const_reference<T>:
	private packing_service_provider<typename std::remove_cv<typename std::remove_reference<T>::type>::type>,		private packing_service_provider<typename std::remove_cv<typename std::remove_reference<T>::type>::type>,
	public package_const_interface_provider<		public package_const_interface_provider<
	typename std::remove_cv<typename std::remove_reference<T>::type>::type,		typename std::remove_cv<typename std::remove_reference<T>::type>::type,
	package_const_reference<typename std::remove_cv<typename std::remove_reference<T>::type>::type>		package_const_reference<typename std::remove_cv<typename std::remove_reference<T>::type>::type>
	>		>
	{		{
	public:		public:
	/The following types are specified by the service provider/		/The following types are specified by the service provider/
	typedef typename sp_t::value_type value_type;		typedef typename sp_t::value_type value_type;
	typedef typename sp_t::const_reference reference, const_reference;		typedef typename sp_t::const_reference reference, const_reference;
	typedef typename sp_t::const_pointer pointer, const_pointer;		typedef typename sp_t::const_pointer pointer, const_pointer;
	typedef typename sp_t::const_get_type get_type, const_get_type;		typedef typename sp_t::const_get_type get_type, const_get_type;
	typedef typename sp_t::size_type size_type;		typedef typename sp_t::size_type size_type;

	template <class U>		template <class U>
	static size_type calculate_size(U&& ref);		static size_type calculate_size(U&& ref);
	static _Success_(return != false) bool verify_package_size(_In_bytecount_(cbBuf) const void* pBuf, size_type cbBuf, _Out_opt_ size_type* pSize = nullptr);		static _Success_(return != false) bool verify_package_size(_In_bytecount_(cbBuf) const void* pBuf, size_type cbBuf, _Out_opt_ size_type* pSize = nullptr);
	package_const_reference();		package_const_reference();
	template <class U>		template <class U>
	package_const_reference(_Out_bytecap_(cbPackedData) void* pPackedData, size_type cbPackedData, _In_ U&& ref);		package_const_reference(_Out_bytecap_(cbPackedData) void* pPackedData, size_type cbPackedData, _In_ U&& ref);
	package_const_reference(_In_bytecount_(cbPackedData) const void* pPackedData, size_type cbPackedData);		package_const_reference(_In_bytecount_(cbPackedData) const void* pPackedData, size_type cbPackedData);
	package_const_reference(const package_reference<T>& ref);		package_const_reference(const package_reference<T>& ref);
	const void* data() const;		const void* data() const;
	size_type size() const;		const void* endptr() const;
			size_type size() const;

	template <class...get_params_t>		template <class...get_params_t>
	const_get_type get(get_params_t&&...get_params) const;		const_get_type get(get_params_t&&...get_params) const;
	};		};
	</source>		</source>

Андрей Чусов: /* Required nonstatic methods */

2016-07-26T05:09:02Z

Required nonstatic methods

← Предыдущая		Версия 15:09, 26 июля 2016
Строка 427:		Строка 427:

	====Required nonstatic methods====		====Required nonstatic methods====
	1) <source lang='cpp' inline>const void* data() const;</source>		# <source lang='cpp' inline>const void* data() const;</source><br/>Returns a constant pointer to a buffer managed by the marshaller.
			# <source lang='cpp' inline>const void* endptr() const;</source><br/>Returns an address of the first byte beyond the package buffer, i.e. the byte data() + size().
	~~returns~~ a constant pointer to a buffer managed by the marshaller.		# <source lang='cpp' inline>size_type size() const;</source><br/>Returns a byte size of a package managed by the marshaller.
			# <source lang='cpp' inline>template <class...get_params_t> const_get_type get(get_params_t&&...get_params) const;</source><br/>A function or a function template with any number of parameters based on which the function returns an object from the package (i.e. a complete object, or its part).<br/>''In addition to the methods above, the following methods must be provided by the package_reference<T> marshaller.''
	2) <source lang='cpp' inline>size_type size() const;</source>		# <source lang='cpp' inline>void* data();</source><br/> Returns a mutable pointer to a buffer managed by the marshaller.
			# <source lang='cpp' inline>void* endptr();</source><br/>Returns a mutable pointer to first byte beyond the package buffer, i.e. the byte data() + size().
	~~returns~~ a byte size of a package managed by the marshaller.		# <source lang='cpp' inline>template <class...get_params_t> get_type get(get_params_t&&...get_params);</source><br/>A function or function template with any number of parameters based on which the function returns an object from a package (i.e. a complete object, or its part).

	3) <source lang='cpp' inline>template <class...get_params_t> const_get_type get(get_params_t&&...get_params) const;</source>

	a function or function template with any number of parameters
	based on which the function returns an object from a package (i.e. a complete object, or its part).

	In addition to the methods above, the following methods must be provided by the ~~\ref~~ package_reference<T> marshaller.

	4) <source lang='cpp' inline>void* data();</source>

	~~returns~~ a mutable pointer to a buffer managed by the marshaller.

	5) <source lang='cpp' inline>template <class...get_params_t> get_type get(get_params_t&&...get_params);</source>

	a function or function template with any number of parameters
	based on which the function returns an object from a package (i.e. a complete object, or its part).

	====Constructors====		====Constructors====