#include <TextBasedProtocol.h>

Inheritance diagram for pcpp::TextBasedProtocolMessage:

Public Member Functions
HeaderField *	getFieldByName (std::string fieldName, int index=0)

HeaderField *	getFirstField ()

HeaderField *	getNextField (HeaderField *prevField)

int	getFieldCount ()

virtual HeaderField *	addField (const std::string &fieldName, const std::string &fieldValue)

virtual HeaderField *	addField (const HeaderField &newField)

HeaderField *	addEndOfHeader ()

virtual HeaderField *	insertField (HeaderField *prevField, const std::string &fieldName, const std::string &fieldValue)

virtual HeaderField *	insertField (std::string prevFieldName, const std::string &fieldName, const std::string &fieldValue)

virtual HeaderField *	insertField (HeaderField *prevField, const HeaderField &newField)

bool	removeField (HeaderField *fieldToRemove)

bool	removeField (std::string fieldName, int index=0)

bool	isHeaderComplete ()

virtual void	parseNextLayer ()

size_t	getHeaderLen ()

virtual void	computeCalculateFields ()

Public Member Functions inherited from pcpp::Layer
virtual	~Layer ()

Layer *	getNextLayer ()

Layer *	getPrevLayer ()

ProtocolType	getProtocol ()

uint8_t *	getData ()

size_t	getDataLen ()

uint8_t *	getLayerPayload ()

size_t	getLayerPayloadSize ()

bool	isAllocatedToPacket ()

void	copyData (uint8_t *toArr)

uint8_t *	getDataPtr (size_t offset=0)

virtual std::string	toString ()=0

virtual OsiModelLayer	getOsiModelLayer ()=0

Detailed Description

An abstract base class that wraps text-based-protocol header layers (both requests and responses). It is the base class for all those layers. This class is not meant to be instantiated, hence the protected c'tor

Member Function Documentation

◆ addEndOfHeader()

HeaderField* pcpp::TextBasedProtocolMessage::addEndOfHeader ( )

Add the special end-of-header field (see the explanation in HeaderField)

Returns: A pointer to the newly created header field, or NULL if the field could not be created

◆ addField() [1/2]

virtual HeaderField* pcpp::TextBasedProtocolMessage::addField	(	const std::string &	fieldName,
		const std::string &	fieldValue
	)

virtual

Add a new header field to this message. This field will be added last (before the end-of-header field)

Parameters

[in]	fieldName	The field name
[in]	fieldValue	The field value

Returns: A pointer to the newly created header field, or NULL if the field could not be created

Reimplemented in pcpp::HttpMessage.

◆ addField() [2/2]

virtual HeaderField* pcpp::TextBasedProtocolMessage::addField ( const HeaderField & newField )

virtual

Add a new header field to this message. This field will be added last (before the end-of-header field)

Parameters

[in] newField The header field to add

Returns: A pointer to the newly created header field, or NULL if the field could not be created

Reimplemented in pcpp::HttpMessage.

◆ computeCalculateFields()

virtual void pcpp::TextBasedProtocolMessage::computeCalculateFields ( )

virtual

Does nothing for this class

Implements pcpp::Layer.

Reimplemented in pcpp::SipLayer.

◆ getFieldByName()

HeaderField* pcpp::TextBasedProtocolMessage::getFieldByName	(	std::string	fieldName,
		int	index = `0`
	)

Get a pointer to a header field by name. The search is case insensitive, meaning if a field with name "Host" exists and the fieldName parameter is "host" (all letter are lower case), this method will return a pointer to "Host" field

Parameters

[in]	fieldName	The field name
[in]	index	Optional parameter. If the field name appears more than once, this parameter will indicate which field to get. The default value is 0 (get the first appearance of the field name as appears on the packet)

Returns: A pointer to an HeaderField instance, or NULL if field doesn't exist

◆ getFieldCount()

int pcpp::TextBasedProtocolMessage::getFieldCount ( )

Returns: The number of header fields currently in the layer (not including CRLF at the end of the header)

◆ getFirstField()

HeaderField* pcpp::TextBasedProtocolMessage::getFirstField ( )

inline

Returns: A pointer to the first header field exists in this message, or NULL if no such field exists

◆ getHeaderLen()

size_t pcpp::TextBasedProtocolMessage::getHeaderLen ( )

virtual

Returns: The message length

Implements pcpp::Layer.

◆ getNextField()

HeaderField* pcpp::TextBasedProtocolMessage::getNextField ( HeaderField * prevField )

inline

Get the field which appears after a certain field

Parameters

[in] prevField A pointer to the field

Returns: The field after prevField or NULL if prevField is the last field. If prevField is NULL, this method will return NULL

◆ insertField() [1/3]

virtual HeaderField* pcpp::TextBasedProtocolMessage::insertField	(	HeaderField *	prevField,
		const std::string &	fieldName,
		const std::string &	fieldValue
	)

virtual

Insert a new field after an existing field

Parameters

[in]	prevField	A pointer to the existing field. If it's NULL the new field will be added as first field
[in]	fieldName	The field name
[in]	fieldValue	The field value

Returns: A pointer to the newly created header field, or NULL if the field could not be created

Reimplemented in pcpp::HttpMessage.

◆ insertField() [2/3]

virtual HeaderField* pcpp::TextBasedProtocolMessage::insertField	(	std::string	prevFieldName,
		const std::string &	fieldName,
		const std::string &	fieldValue
	)

virtual

Insert a new field after an existing field

Parameters

[in]	prevFieldName	A name of an existing field. If the field doesn't exist NULL will be returned. If field name is empty ('') the new field will be added as first field
[in]	fieldName	The field name
[in]	fieldValue	The field value

Returns: A pointer to the newly created header field, or NULL if the field could not be created

◆ insertField() [3/3]

virtual HeaderField* pcpp::TextBasedProtocolMessage::insertField	(	HeaderField *	prevField,
		const HeaderField &	newField
	)

virtual

Insert a new field after an existing field

Parameters

[in]	prevField	A pointer to the existing field
[in]	newField	The header field to add

Returns: A pointer to the newly created header field, or NULL if the field could not be created

Reimplemented in pcpp::HttpMessage.

◆ isHeaderComplete()

bool pcpp::TextBasedProtocolMessage::isHeaderComplete ( )

Indicate whether the header is complete (ending with end-of-header "\r\n\r\n" or "\n\n") or spread over more packets

Returns: True if the header is complete or false if not

◆ parseNextLayer()

virtual void pcpp::TextBasedProtocolMessage::parseNextLayer ( )

virtual

Currently set only PayloadLayer for the rest of the data

Implements pcpp::Layer.

Reimplemented in pcpp::SipLayer.

◆ removeField() [1/2]

bool pcpp::TextBasedProtocolMessage::removeField ( HeaderField * fieldToRemove )

Remove a field from the message

Parameters

[in] fieldToRemove A pointer to the field that should be removed

Returns: True if the field was removed successfully, or false otherwise (for example: if fieldToRemove is NULL, if it doesn't exist in the message, or if the removal failed)

◆ removeField() [2/2]

bool pcpp::TextBasedProtocolMessage::removeField	(	std::string	fieldName,
		int	index = `0`
	)

Remove a field from the message

Parameters

[in]	fieldName	The name of the field that should be removed
[in]	index	Optional parameter. If the field name appears more than once, this parameter will indicate which field to remove. The default value is 0 (remove the first appearance of the field name as appears on the packet)

Returns: True if the field was removed successfully, or false otherwise (for example: if fieldName doesn't exist in the message, or if the removal failed)

Public Member Functions

Detailed Description

Member Function Documentation

◆ addEndOfHeader()

◆ addField() [1/2]

◆ addField() [2/2]

◆ computeCalculateFields()

◆ getFieldByName()

◆ getFieldCount()

◆ getFirstField()

◆ getHeaderLen()

◆ getNextField()

◆ insertField() [1/3]

◆ insertField() [2/3]

◆ insertField() [3/3]

◆ isHeaderComplete()

◆ parseNextLayer()

◆ removeField() [1/2]

◆ removeField() [2/2]