X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=senf%2FPackets%2FPacketData.hh;h=095c9c58ccf1ae872f45873f592f054b292c95e7;hb=7ee689fe38d66aa3a0004d55e8708750d35adc0b;hp=08600625777009a7b78ffbcda74b0ef28d60d164;hpb=82e794070d4f3ae8aacb1827b21a93b9d48ce57f;p=senf.git diff --git a/senf/Packets/PacketData.hh b/senf/Packets/PacketData.hh index 0860062..095c9c5 100644 --- a/senf/Packets/PacketData.hh +++ b/senf/Packets/PacketData.hh @@ -29,12 +29,10 @@ // Custom includes #include #include -#include #include -#include "PacketTypes.hh" //#include "PacketData.mpp" -///////////////////////////////hh.p//////////////////////////////////////// +//-///////////////////////////////////////////////////////////////////////////////////////////////// namespace senf { @@ -46,12 +44,12 @@ namespace senf { Whenever the data is manipulated through PacketData, the change is assumed to be within the data range of that packet: All insertions take place \e inside \c this packet and \e outside - any following packets in the packet chain. + any following packets in the packet chain. \warning It is not permissible to change data belonging to a following packet/header/interpreter even though this data is part of \c this sequence. Doing so will corrupt the packet data. - + \par \warning When accessing packet data via the PacketData interface you are on your own: The @@ -70,7 +68,7 @@ namespace senf { : boost::noncopyable { public: - /////////////////////////////////////////////////////////////////////////// + //-//////////////////////////////////////////////////////////////////////// // Types typedef senf::detail::packet::iterator iterator; @@ -84,30 +82,30 @@ namespace senf { typedef byte * pointer; typedef byte const * const_pointer; - /////////////////////////////////////////////////////////////////////////// + //-//////////////////////////////////////////////////////////////////////// ///\name Structors and default members - ///@{ + //\{ // no public constructors // no conversion constructors - ///@} - /////////////////////////////////////////////////////////////////////////// - + //\} + //-//////////////////////////////////////////////////////////////////////// + ///\name Sequence interface to raw data - ///@{ + //\{ iterator begin() const; ///< Return iterator to beginning /**< Returns an random access iterator referring to the first byte of the packet data. */ - iterator end() const; ///< Return iterator to end - /**< Returns an random access iterator referring to the + iterator end() const; ///< Return iterator to end + /**< Returns an random access iterator referring to the byte past the end of the packet data. */ size_type size() const; ///< Returns the number of bytes in the packet data. bool empty() const; ///< Test whether the packet data is empty. /**< Returns whether the packet data is empty, i.e. whether its size - is 0. This function does not modify the content of the packet - data in any way. To clear the content use clear() */ + is 0. This function does not modify the content of the packet + data in any way. To clear the content use clear() */ byte operator[](size_type n) const; ///< Access byte in the packet data byte & operator[](size_type n); ///< Access byte in the packet data @@ -130,13 +128,13 @@ namespace senf { void erase(iterator pos); void erase(iterator first, iterator last); void clear(); ///< All bytes of the packet data dropped, leaving the container with a size of 0. */ - + void resize(size_type n, byte v=0); void reserve(size_type n); size_type capacity() const; - ///@} + //\} protected: PacketData(size_type b, size_type e); @@ -167,7 +165,7 @@ namespace senf { } -///////////////////////////////hh.e//////////////////////////////////////// +//-///////////////////////////////////////////////////////////////////////////////////////////////// #endif #if !defined(HH_SENF_Packets_Packets__decls_) && !defined(HH_SENF_Packets_PacketData_i_) #define HH_SENF_Packets_PacketData_i_