Base class to represent items of packet Queues. More...

#include "queue-item.h"

Inheritance diagram for ns3::QueueItem:

Collaboration diagram for ns3::QueueItem:

Public Types
typedef void(*	TracedCallback) (Ptr< const QueueItem > item)
	TracedCallback signature for Ptr<QueueItem> More...

enum	Uint8Values { IP_DSFIELD }
	1-byte fields of the packet whose value can be retrieved, if present More...

Public Member Functions
	QueueItem ()=delete

	QueueItem (const QueueItem &)=delete

	QueueItem (Ptr< Packet > p)
	Create a queue item containing a packet. More...

virtual	~QueueItem ()

Ptr< Packet >	GetPacket (void) const

virtual uint32_t	GetSize (void) const
	Use this method (instead of GetPacket ()->GetSize ()) to get the packet size. More...

virtual bool	GetUint8Value (Uint8Values field, uint8_t &value) const
	Retrieve the value of a given field from the packet, if present. More...

QueueItem &	operator= (const QueueItem &)=delete

virtual void	Print (std::ostream &os) const
	Print the item contents. More...

Public Member Functions inherited from ns3::SimpleRefCount< QueueItem >
	SimpleRefCount ()
	Default constructor. More...

	SimpleRefCount (const SimpleRefCount &o[[maybe_unused]])
	Copy constructor. More...

uint32_t	GetReferenceCount (void) const
	Get the reference count of the object. More...

SimpleRefCount &	operator= ([[maybe_unused]] const SimpleRefCount &o)
	Assignment operator. More...

void	Ref (void) const
	Increment the reference count. More...

void	Unref (void) const
	Decrement the reference count. More...

Private Attributes
Ptr< Packet >	m_packet
	The packet contained in the queue item. More...

Detailed Description

Base class to represent items of packet Queues.

An item stored in an ns-3 packet Queue contains a packet and possibly other information. An item of the base class only contains a packet. Subclasses can be derived from this base class to allow items to contain additional information.

Definition at line 46 of file queue-item.h.

Member Typedef Documentation

◆ TracedCallback

typedef void(* ns3::QueueItem::TracedCallback) (Ptr< const QueueItem > item)

TracedCallback signature for Ptr<QueueItem>

Parameters

[in] item The queue item.

Definition at line 106 of file queue-item.h.

Member Enumeration Documentation

◆ Uint8Values

enum ns3::QueueItem::Uint8Values

1-byte fields of the packet whose value can be retrieved, if present

Enumerator
IP_DSFIELD

Definition at line 81 of file queue-item.h.

Constructor & Destructor Documentation

◆ QueueItem() [1/3]

ns3::QueueItem::QueueItem ( Ptr< Packet > p )

Create a queue item containing a packet.

Parameters

p	the packet included in the created item.

Definition at line 29 of file queue-item.cc.

References m_packet, and NS_LOG_FUNCTION.

◆ ~QueueItem()

ns3::QueueItem::~QueueItem ( )

virtual

Definition at line 35 of file queue-item.cc.

References m_packet, and NS_LOG_FUNCTION.

◆ QueueItem() [2/3]

ns3::QueueItem::QueueItem ( )

delete

◆ QueueItem() [3/3]

ns3::QueueItem::QueueItem ( const QueueItem & )

delete

Member Function Documentation

◆ GetPacket()

Ptr< Packet > ns3::QueueItem::GetPacket ( void ) const

Returns: the packet included in this item.

Definition at line 42 of file queue-item.cc.

References m_packet, and NS_LOG_FUNCTION.

Referenced by ns3::ArpQueueDiscItem::AddHeader(), ns3::Ipv4QueueDiscItem::AddHeader(), ns3::Ipv6QueueDiscItem::AddHeader(), UdpSocketImplTest::GetPriority(), ns3::ArpQueueDiscItem::GetSize(), ns3::Ipv4QueueDiscItem::GetSize(), ns3::Ipv6QueueDiscItem::GetSize(), ns3::Ipv4QueueDiscItem::Hash(), ns3::Ipv6QueueDiscItem::Hash(), ns3::ArpQueueDiscItem::Print(), ns3::Ipv4QueueDiscItem::Print(), ns3::Ipv6QueueDiscItem::Print(), Print(), and ns3::QueueDiscItem::Print().

Here is the caller graph for this function:

◆ GetSize()

uint32_t ns3::QueueItem::GetSize ( void ) const

virtual

Use this method (instead of GetPacket ()->GetSize ()) to get the packet size.

Subclasses may keep header and payload separate to allow manipulating the header, so using this method ensures that the correct packet size is returned.