X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=Packets%2FPacket.hh;h=7fa54faf09f69609dba710895aeae63d7c82d138;hb=82ad2ed94c12c3e53097fef92978de8c28239fab;hp=d04c6ae192e7266a6fb8a44c76256c6a21b11f0b;hpb=e61f824b022bb50e9e04598db860a67b644b6818;p=senf.git diff --git a/Packets/Packet.hh b/Packets/Packet.hh index d04c6ae..7fa54fa 100644 --- a/Packets/Packet.hh +++ b/Packets/Packet.hh @@ -27,8 +27,8 @@ // Custom includes #include -#include "Utils/Exception.hh" -#include "Utils/SafeBool.hh" +#include "../Utils/Exception.hh" +#include "../Utils/SafeBool.hh" #include "PacketInterpreter.hh" //#include "Packet.mpp" @@ -184,6 +184,8 @@ namespace senf { Packet next() const; ///< Get next packet in chain + /**< \returns in - valid() packet, if no next packet + exists */ template OtherPacket next() const; ///< Get next packet of given type in chain /**< \throws InvalidPacketChainException if no such packet @@ -192,7 +194,8 @@ namespace senf { ///< Get next packet of given type in chain /**< \param[in] nothrow This argument always has the value \c senf::nothrow - \returns in-valid() packet, if no such packet is found */ + \returns in - valid() packet, if no such packet is + found */ template OtherPacket findNext() const; ///< Find next packet of given type in chain /**< findNext() is like next(), it will however return \c @@ -205,11 +208,14 @@ namespace senf { *this if it is of the given type. \param[in] nothrow This argument always has the value \c senf::nothrow - \returns in-valid() packet, if no such packet is found */ + \returns in - valid() packet, if no such packet is + found */ Packet prev() const; ///< Get previous packet in chain + /**< \returns in - valid() packet, if no previous packet + exists */ template OtherPacket prev() const; ///< Get previous packet of given type in chain /**< \throws InvalidPacketChainException if no such packet @@ -218,7 +224,8 @@ namespace senf { ///< Get previous packet of given type in chain /**< \param[in] nothrow This argument always has the value \c senf::nothrow - \returns in-valid() packet, if no such packet is found */ + \returns in - valid() packet, if no such packet is + found */ template OtherPacket findPrev() const; ///< Find previous packet of given type in chain /**< findPrev() is like prev(), it will however return \c @@ -231,7 +238,8 @@ namespace senf { *this if it is of the type \param[in] nothrow This argument always has the value \c senf::nothrow - \returns in-valid() packet, if no such packet is found */ + \returns in - valid() packet, if no such packet is + found */ Packet first() const; @@ -244,7 +252,8 @@ namespace senf { ///< Return first packet of given type in chain /**< \param[in] nothrow This argument always has the value \c senf::nothrow - \returns in-valid() packet, if no such packet is found */ + \returns in - valid() packet, if no such packet is + found */ Packet last() const; ///< Return last packet in chain @@ -256,7 +265,8 @@ namespace senf { ///< Return last packet of given type in chain /**< \param[in] nothrow This argument always has the value \c senf::nothrow - \returns in-valid() packet, if no such packet is found */ + \returns in - valid() packet, if no such packet is + found */ template OtherPacket parseNextAs() const; @@ -321,10 +331,12 @@ namespace senf { bool boolean_test() const; ///< Check, whether the packet is valid() /**< \see valid() */ bool valid() const; ///< Check, whether the packet is valid() - /**< An in-valid() packet does not allow any operation - except checking for validity and assignment. in-valid() - packets serve the same role as 0-pointers. */ - + /**< An in - valid() packet does not allow any operation + except checking for validity and assignment. in - + valid() packets serve the same role as 0-pointers. + + This is an alias for boolean_test() which is called + when using a packet in a boolean context. */ void finalize() const; ///< Update calculated fields /**< This call will update all calculated fields of the @@ -372,6 +384,7 @@ namespace senf { template friend class ConcretePacket; + friend class PacketParserBase; }; /** \brief Protocol specific packet handle @@ -581,7 +594,7 @@ namespace senf { ///////////////////////////////hh.e//////////////////////////////////////// #endif -#if !defined(SENF_PACKETS_DECL_ONLY) && !defined(HH_Packet_i_) +#if !defined(HH_Packets__decls_) && !defined(HH_Packet_i_) #define HH_Packet_i_ #include "Packet.cci" #include "Packet.ct"