namespace senf {
- namespace detail { template <class ElementParser, class BytesParser>
- class ListBParser_Policy; }
-
- /** \brief List parser with size-field in bytes
-
- This list parser will parse a list which size is given by a preceding field containing the
- length of the list in bytes. This struct is just a template typedef:
- \code
- typedef senf::VectorNParser< Parser_UInt32, Parser_UInt16 >::parser MyVectorParser;
- typedef senf::ListBParser< MyVectorParser, UInt16Parser >::parser MyListParser;
- \endcode
- This first defines a Vector of 32 bit unsigned integers with 16 bit length counter. Then it
- defines a list of such vectors with a 16 bit bytes field.
-
- \warning There are some caveats when working with this kind of list
- \li You may <b>only change the size of a contained element from a container wrapper</b>.
- \li While you hold a container wrapper, <b>only access the packet through this wrapper</b>
- or a nested wrapper either for reading or writing.
-
- If lists are nested, you need to allocate a container wrapper for each level and may only
- access the packet through the lowest-level active container wrapper.
-
- \implementation These restrictions are necessary to ensure correct recalculation of the
- <tt>bytes</tt> field. For more info, see the comments in \ref ListBParser.ih
-
- \see ListParser
- \ingroup parsecollection
- */
- template <class ElementParser, class BytesParser>
- struct ListBParser {
- typedef ListParser<
- detail::ListBParser_Policy< ElementParser,
- detail::PrefixAuxParserPolicy<BytesParser> > > parser;
- };
-
- /** \brief Define ListBParser field
-
- This macro is a special helper to define a senf::ListBParser type field, a list of elements
- of type \a elt_type (a parser type) directly preceded by a numeric size field of type \a
- size_type (another parser type) giving the total number of bytes of the list (not the
- element count).
-
- \param[in] name field name
- \param[in] elt_type list element type
- \param[in] size_type size type
- \hideinitializer
- \ingroup packetparsermacros
- */
-# define SENF_PARSER_LIST_B(name, elt_type, size_type) \
- typedef senf::ListBParser<elt_type, size_type>::parser BOOST_PP_CAT(name, _list_t); \
- SENF_PARSER_FIELD( name, BOOST_PP_CAT(name, _list_t) )
}
///////////////////////////////hh.e////////////////////////////////////////