+// $Id$
+//
// Copyright (C) 2007
// Fraunhofer Institut fuer offene Kommunikationssysteme (FOKUS)
// Kompetenzzentrum fuer Satelitenkommunikation (SatCom)
/** \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
- lenght of the list in bytes. This struct is just a template typedef:
+ length of the list in bytes. This struct is just a template typedef:
\code
- typedef senf::Parse_VectorN< Parser_UInt32, Parser_UInt16 >::parser Parse_MyVector;
- typedef senf::Parse_ListB< Parse_MyVector, Parse_UInt16 >::parser Parse_MyList;
+ typedef senf::Parse_VectorN< Parser_UInt32, Parser_UInt16 >::parser Parse_MyVector;
+ typedef senf::Parse_ListB< Parse_MyVector, Parse_UInt16 >::parser Parse_MyList;
\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 wrepper either for reading or writing.
+ 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 ParseListB.ih
+
+ \see Parse_List
+ \ingroup parsecollection
*/
template <class ElementParser, class BytesParser>
struct Parse_ListB {
typedef Parse_List< detail::Parse_ListB_Policy<ElementParser,BytesParser> > parser;
};
+ /** \brief Define Parse_ListB field
+
+ This macro is a special helper to define a senf::Parse_ListB 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::Parse_ListB<elt_type, size_type>::parser BOOST_PP_CAT(name, _list_t); \
+ SENF_PARSER_FIELD( name, BOOST_PP_CAT(name, _list_t) )
+
}
///////////////////////////////hh.e////////////////////////////////////////
#endif
-#if !defined(SENF_PACKETS_DECL_ONLY) && !defined(HH_ParseListB_i_)
+#if !defined(HH_Packets__decls_) && !defined(HH_ParseListB_i_)
#define HH_ParseListB_i_
//#include "ParseListB.cci"
//#include "ParseListB.ct"