Packets: Add StringParser ostream operation
[senf.git] / Packets / ListBParser.hh
index b35ba40..76227c0 100644 (file)
@@ -1,8 +1,8 @@
 // $Id$
 //
-// Copyright (C) 2007 
-// Fraunhofer Institute for Open Communication Systems (FOKUS) 
-// Competence Center NETwork research (NET), St. Augustin, GERMANY 
+// Copyright (C) 2007
+// Fraunhofer Institute for Open Communication Systems (FOKUS)
+// Competence Center NETwork research (NET), St. Augustin, GERMANY
 //     Stefan Bund <g0dil@berlios.de>
 //
 // This program is free software; you can redistribute it and/or modify
@@ -23,8 +23,8 @@
 /** \file
     \brief ListBParser public header */
 
-#ifndef HH_ListBParser_
-#define HH_ListBParser_ 1
+#ifndef HH_SENF_Packets_ListBParser_
+#define HH_SENF_Packets_ListBParser_ 1
 
 // Custom includes
 #include "ListParser.hh"
 ///////////////////////////////hh.p////////////////////////////////////////
 
 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,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////////////////////////////////////////
 #endif
-#if !defined(HH_Packets__decls_) && !defined(HH_ListBParser_i_)
-#define HH_ListBParser_i_
+#if !defined(HH_SENF_Packets_Packets__decls_) && !defined(HH_SENF_Packets_ListBParser_i_)
+#define HH_SENF_Packets_ListBParser_i_
 //#include "ListBParser.cci"
 //#include "ListBParser.ct"
 #include "ListBParser.cti"