pcpp::MacAddress Class Reference

#include <MacAddress.h>

Public Member Functions
	MacAddress ()
	MacAddress (const uint8_t *addr)
	MacAddress (const char *addr)
	MacAddress (const std::string &addr)
	MacAddress (uint8_t firstOctest, uint8_t secondOctet, uint8_t thirdOctet, uint8_t fourthOctet, uint8_t fifthOctet, uint8_t sixthOctet)
bool	operator== (const MacAddress &other) const
bool	operator!= (const MacAddress &other) const
const uint8_t *	getRawData () const
bool	isValid () const
std::string	toString () const
void	copyTo (uint8_t **arr) const
void	copyTo (uint8_t *arr) const

Static Public Attributes
static MacAddress	Zero

Detailed Description

Represents L2 MAC addresses. Can be constructed from string or a series of 6 byte octets

Constructor & Destructor Documentation

MacAddress() [1/5]

pcpp::MacAddress::MacAddress ( )

inline

Default constructor for this class. Initializes object to me MacAddress::Zero

MacAddress() [2/5]

pcpp::MacAddress::MacAddress ( const uint8_t *  addr )

inline

A constructor that creates an instance of the class out of a byte array. The byte array length must be equal or greater to 6 (as MAC address is 6-byte long)

Parameters

[in]

addr

A pointer to the byte array containing 6 bytes representing the MAC address

MacAddress() [3/5]

pcpp::MacAddress::MacAddress ( const char *  addr )

inline

A constructor that creates an instance of the class out of a (char*) string. If the string doesn't represent a valid MAC address, instance will be invalid, meaning isValid() will return false

Parameters

[in]

addr

A pointer to the (char*) string

MacAddress() [4/5]

pcpp::MacAddress::MacAddress ( const std::string &  addr )

inline

A constructor that creates an instance of the class out of a std::string. If the string doesn't represent a valid MAC address, instance will be invalid, meaning isValid() will return false

Parameters

[in]

addr

A pointer to the string

MacAddress() [5/5]

pcpp::MacAddress::MacAddress ( uint8_t  firstOctest, uint8_t  secondOctet, uint8_t  thirdOctet, uint8_t  fourthOctet, uint8_t  fifthOctet, uint8_t  sixthOctet  )

inline

A constructor that creates an instance of 6 bytes representing the MAC address

Parameters

[in]	firstOctest	Represent the first octet in the address
[in]	secondOctet	Represent the second octet in the address
[in]	thirdOctet	Represent the third octet in the address
[in]	fourthOctet	Represent the fourth octet in the address
[in]	fifthOctet	Represent the fifth octet in the address
[in]	sixthOctet	Represent the sixth octet in the address

Member Function Documentation

copyTo() [1/2]

void pcpp::MacAddress::copyTo ( uint8_t **  arr ) const

inline

Allocates a byte array of length 6 and copies address value into it. Array deallocation is user responsibility

Parameters

[in]

arr

A pointer to where array will be allocated

copyTo() [2/2]

void pcpp::MacAddress::copyTo ( uint8_t *  arr ) const

inline

Gets a pointer to an already allocated byte array and copies the address value to it. This method assumes array allocated size is at least 6 (the size of a MAC address)

Parameters

[in]

arr

A pointer to the array which address will be copied to

getRawData()

const uint8_t* pcpp::MacAddress::getRawData ( ) const

inline

Returns the pointer to raw data

Returns

The pointer to raw data

isValid()

bool pcpp::MacAddress::isValid ( ) const

inline

Get an indication whether the MAC address is valid. An address can be invalid if it was constructed from illegal input, for example: invalid string

Returns

True if the address is valid, false otherwise

operator!=()

bool pcpp::MacAddress::operator!= ( const MacAddress &  other ) const

inline

Overload of the not-equal operator

Parameters

[in]

other

The object to compare with

Returns

True if addresses are not equal, false otherwise

operator==()

bool pcpp::MacAddress::operator== ( const MacAddress &  other ) const

inline

Overload of the comparison operator

Parameters

[in]

other

The object to compare with

Returns

True if addresses are equal, false otherwise

toString()

std::string pcpp::MacAddress::toString

(

)

const

Returns a std::string representation of the address

Returns

A string representation of the address

Member Data Documentation

Zero

MacAddress pcpp::MacAddress::Zero

static

A static value representing a zero value of MAC address, meaning address of value "00:00:00:00:00:00"