4 // Fraunhofer Institut fuer offene Kommunikationssysteme (FOKUS)
5 // Kompetenzzentrum fuer Satelitenkommunikation (SatCom)
6 // Stefan Bund <stefan.bund@fokus.fraunhofer.de>
8 // This program is free software; you can redistribute it and/or modify
9 // it under the terms of the GNU General Public License as published by
10 // the Free Software Foundation; either version 2 of the License, or
11 // (at your option) any later version.
13 // This program is distributed in the hope that it will be useful,
14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 // GNU General Public License for more details.
18 // You should have received a copy of the GNU General Public License
19 // along with this program; if not, write to the
20 // Free Software Foundation, Inc.,
21 // 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
24 \brief ParseArray public header */
26 #ifndef HH_ParseArray_
27 #define HH_ParseArray_ 1
29 /** \defgroup parsecollection Collection parsers
31 Collection parsers are parsers which build collections from other parsers. Examples are a vector
32 of 16bit unsigned integers or a list of lists of 32bit numbers and so on.
34 Collection parsers provide a (reduced) STL sequence like interface. It depends on the type of
35 collection parser, what kind of sequence is modelled (e.g. random access sequence, forward
36 sequence etc). Most collections will also provide a kind of container wrapper to allow extensive
37 manipulations of the collection contents. A container wrapper is initialized with the collection
38 parser and then provides a more complete sequence interface. Additionally, the collection
39 wrapper has a longer lifetime than an ordinary parser: While a parser will be invalidated
40 whenever the collection is changed, the container wrapper will stay valid as long as the
41 collection is changed through the wrapper (directly or indirectly, where indirectly means that a
42 sub-field or sub-collection of the collection is changed). Some collections may provide even
43 more lifetime guarantees but this guarantee should be met by all collection wrappers.
45 \important Parser lifetime has to be tightly checked when working with collection parsers since
46 \e every change of the collections size will invalidate \e all parsers and iterators referencing
47 the \e complete packet chain. Collection wrappers do \e not invalidate if the change is \e after
54 #include "PacketParser.hh"
56 //#include "ParseArray.mpp"
57 ///////////////////////////////hh.p////////////////////////////////////////
61 namespace detail { template <class> class Parse_Array_iterator; }
63 /** \brief Fixed size collection of fixed size elements
65 Parse_Array will parse a sequence of <em>fixed size</em> parsers. The number of array
66 elements is given by the \e elements template parameter and is fixed at compile time.
68 Each element will be parsed by \a ElementParser, which can be any <em>fixed size</em>
69 parser. The array models an STL random-access sequence with the restriction that elements
70 cannot be added or removed since the size is fixed.
72 \ingroup parsecollection
74 template <unsigned elements, class ElementParser>
75 struct Parse_Array : public PacketParserBase
77 Parse_Array(data_iterator i, state_type s);
79 static size_type const fixed_bytes = elements*ElementParser::fixed_bytes;
83 ///////////////////////////////////////////////////////////////////////////
84 // Container interface
86 typedef ElementParser value_type;
87 typedef detail::Parse_Array_iterator<value_type> iterator;
88 typedef iterator const_iterator;
90 static size_type size();
92 iterator begin() const;
95 value_type operator[](difference_type i) const;
100 ///////////////////////////////hh.e////////////////////////////////////////
102 #if !defined(SENF_PACKETS_DECL_ONLY) && !defined(HH_ParseArray_i_)
103 #define HH_ParseArray_i_
104 //#include "ParseArray.cci"
105 //#include "ParseArray.ct"
106 #include "ParseArray.cti"
113 // c-file-style: "senf"
114 // indent-tabs-mode: nil
115 // ispell-local-dictionary: "american"
116 // compile-command: "scons -u test"
117 // comment-column: 40