Represents a hardware address. More...

#include <hw_address.h>

Public Types
typedef uint8_t	storage_type
	The type of the elements stored in the hardware address.

typedef storage_type *	iterator
	The random access iterator type.

typedef const storage_type *	const_iterator
	Const iterator type.

Public Member Functions
	HWAddress (const storage_type *ptr=0)
	Constructor from a const storage_type*.

	HWAddress (const std::string &address)
	Constructs an address from a hex-notation address.

template<size_t i>
	HWAddress (const char(&address)[i])
	Overload provided basically for string literals.

template<size_t i>
	HWAddress (const HWAddress< i > &rhs)
	Copy construct from a HWAddress of length i.

iterator	begin ()
	Retrieves an iterator pointing to the begining of the address.

const_iterator	begin () const
	Retrieves a const iterator pointing to the begining of the address.

iterator	end ()
	Retrieves an iterator pointing one-past-the-end of the address.

const_iterator	end () const
	Retrieves a const iterator pointing one-past-the-end of the address.

bool	operator== (const HWAddress &rhs) const
	Compares this HWAddress for equality.

bool	operator!= (const HWAddress &rhs) const
	Compares this HWAddress for in-equality.

bool	operator< (const HWAddress &rhs) const
	Compares this HWAddress for less-than inequality.

bool	operator<= (const HWAddress &rhs) const
	Compares this HWAddress for less-than equality.

bool	operator> (const HWAddress &rhs) const
	Compares this HWAddress for greater-than inequality.

bool	operator>= (const HWAddress &rhs) const
	Compares this HWAddress for greater-than equality.

HWAddress	operator& (const HWAddress &mask) const
	Apply a mask to this address.

HWAddress	operator\| (const HWAddress &mask) const
	Apply a mask to this address.

HWAddress	operator~ () const
	not operator

size_t	size () const
	Retrieves the size of this address.

bool	is_broadcast () const
	Indicates whether this is a broadcast address.

bool	is_multicast () const
	Indicates whether this is a multicast address.

bool	is_unicast () const
	Indicates whether this is an unicast address.

std::string	to_string () const
	Convert this address to a hex-notation std::string address.

storage_type	operator[] (size_t i) const
	Retrieves the i-th storage_type in this address.

storage_type &	operator[] (size_t i)
	Retrieves the i-th storage_type in this address.

template<typename OutputIterator >
OutputIterator	copy (OutputIterator output) const
	Helper function which copies the address into an output iterator.

Static Public Attributes
static const size_t	address_size = n
	Non-member constant indicating the amount of storage_type elements in this address.

static const HWAddress< n >	broadcast = make_broadcast_address()
	The broadcast address.

Friends
std::ostream &	operator<< (std::ostream &os, const HWAddress &addr)
	Writes this HWAddress in hex-notation to a std::ostream.

Detailed Description

template<size_t n>
class Tins::HWAddress< n >

Represents a hardware address.

This class represents a hardware (MAC) address. It can be constructed from it's string representation and you can iterate over the bytes that compose it.

For example:

// Construct it from a string.
HWAddress<6> address("00:01:fa:9e:1a:cd");
 
// Iterate over its bytes.
for(auto element : address) {
    // element will be each of the bytes(\x00, \x01, \xfa, etc)
}

Constructor & Destructor Documentation

◆ HWAddress() [1/4]

template<size_t n>

Tins::HWAddress< n >::HWAddress ( const storage_type * ptr = 0 )

inline

Constructor from a const storage_type*.

If no pointer or a null pointer is provided, the address is initialized to 00:00:00:00:00:00.

This constructor is very usefull when passing zero initialized addresses as arguments to other functions. You can use a literal 0, which will be implicitly converted to the empty address.

If a pointer is provided, address_size storage_type elements are copied from the pointer, into the internal address representation.

Parameters

ptr	The pointer from which to construct this address.

◆ HWAddress() [2/4]

template<size_t n>

Tins::HWAddress< n >::HWAddress ( const std::string & address )

inline

Constructs an address from a hex-notation address.

This constructor will parse strings in the form:

"00:01:da:fa:..."

And initialize the internal representation accordingly.

Parameters

address The hex-notation address to be parsed.

◆ HWAddress() [3/4]

template<size_t n>

template<size_t i>

Tins::HWAddress< n >::HWAddress ( const char(&) address[i] )

inline

Overload provided basically for string literals.

This constructor takes a const char array of i elements in hex-notation.

See also: HWAddress::HWAddress(const std::string& address)

This is mostly used when providing string literals. If this where a const char*, then there would be an ambiguity when providing a null pointer.

Parameters

address The array of chars containing the hex-notation cstring to be parsed.

◆ HWAddress() [4/4]

template<size_t n>

template<size_t i>

Tins::HWAddress< n >::HWAddress ( const HWAddress< i > & rhs )

inline

Copy construct from a HWAddress of length i.

If i is lower or equal than address_size, then i storage_type elements are copied, and the last (n - i) are initialized to the default storage_type value(0 most of the times).

If i is larger than address_size, then only the first address_size elements are copied.

Parameters

rhs	The HWAddress to be constructed from.

Member Function Documentation

◆ begin() [1/2]

template<size_t n>

iterator Tins::HWAddress< n >::begin ( )

inline

Retrieves an iterator pointing to the begining of the address.

Returns: iterator.

◆ begin() [2/2]

template<size_t n>

const_iterator Tins::HWAddress< n >::begin ( ) const

inline

Retrieves a const iterator pointing to the begining of the address.

Returns: const_iterator.

◆ copy()

template<size_t n>

template<typename OutputIterator >

OutputIterator Tins::HWAddress< n >::copy ( OutputIterator output ) const

inline

Helper function which copies the address into an output iterator.

This is the same as:

std::copy(begin(), end(), iter);

But since some PDUs return a HWAddress<> by value, this function can be used to avoid temporaries.

Parameters

output The output iterator in which to store this address.

Returns: OutputIterator pointing to one-past the last position written.

◆ end() [1/2]

template<size_t n>

iterator Tins::HWAddress< n >::end ( )

inline

Retrieves an iterator pointing one-past-the-end of the address.

Returns: iterator.

◆ end() [2/2]

template<size_t n>

const_iterator Tins::HWAddress< n >::end ( ) const

inline

Retrieves a const iterator pointing one-past-the-end of the address.

Returns: const_iterator.

◆ operator!=()

template<size_t n>

bool Tins::HWAddress< n >::operator!= ( const HWAddress< n > & rhs ) const

inline

Compares this HWAddress for in-equality.

Parameters

rhs	The HWAddress to be compared to.

Returns: bool indicating whether addresses are distinct.

◆ operator&()

template<size_t n>

HWAddress Tins::HWAddress< n >::operator& ( const HWAddress< n > & mask ) const

inline

Apply a mask to this address.

Parameters

mask	The mask to be applied

Returns: The result of applying the mask to this address

◆ operator<()

template<size_t n>

bool Tins::HWAddress< n >::operator< ( const HWAddress< n > & rhs ) const

inline

Compares this HWAddress for less-than inequality.

Parameters

rhs	The HWAddress to be compared to.

Returns: bool indicating whether this address is less-than rhs.

◆ operator<=()

template<size_t n>

bool Tins::HWAddress< n >::operator<= ( const HWAddress< n > & rhs ) const

inline

Compares this HWAddress for less-than equality.

Parameters

rhs	The HWAddress to be compared to.

Returns: bool indicating whether this address is equal or less-than rhs.

◆ operator==()

template<size_t n>

bool Tins::HWAddress< n >::operator== ( const HWAddress< n > & rhs ) const

inline

Compares this HWAddress for equality.

Parameters

rhs	The HWAddress to be compared to.

Returns: bool indicating whether addresses are equal.

◆ operator>()

template<size_t n>

bool Tins::HWAddress< n >::operator> ( const HWAddress< n > & rhs ) const

inline

Compares this HWAddress for greater-than inequality.

Parameters

rhs	The HWAddress to be compared to.

Returns: bool indicating whether this address is greater-than rhs.

◆ operator>=()

template<size_t n>

bool Tins::HWAddress< n >::operator>= ( const HWAddress< n > & rhs ) const

inline

Compares this HWAddress for greater-than equality.

Parameters

rhs	The HWAddress to be compared to.

Returns: bool indicating whether this address is equal or greater-than rhs.

◆ operator[]() [1/2]

template<size_t n>

storage_type & Tins::HWAddress< n >::operator[] ( size_t i )

inline

Retrieves the i-th storage_type in this address.

Parameters

i	The element to retrieve.

◆ operator[]() [2/2]

template<size_t n>

storage_type Tins::HWAddress< n >::operator[] ( size_t i ) const

inline

Retrieves the i-th storage_type in this address.

Parameters

i	The element to retrieve.

◆ operator|()

template<size_t n>

HWAddress Tins::HWAddress< n >::operator| ( const HWAddress< n > & mask ) const

inline

Apply a mask to this address.

Parameters

mask	The mask to be applied

Returns: The result of applying the mask to this address

◆ operator~()

template<size_t n>

HWAddress Tins::HWAddress< n >::operator~ ( ) const

inline

not operator

Returns: The result of applying the mask to this address

◆ size()

template<size_t n>

size_t Tins::HWAddress< n >::size ( ) const

inline

Retrieves the size of this address.

This effectively returns the address_size constant.

◆ to_string()

template<size_t n>

std::string Tins::HWAddress< n >::to_string ( ) const

inline

Convert this address to a hex-notation std::string address.

Returns: std::string containing the hex-notation address.

Friends And Related Symbol Documentation

◆ operator<<

template<size_t n>

std::ostream & operator<<	(	std::ostream &	os,
		const HWAddress< n > &	addr
	)

friend

Writes this HWAddress in hex-notation to a std::ostream.

Parameters

os	The stream in which to write the address.
addr	The parameter to be written.

Returns: std::ostream& pointing to the os parameter.

The documentation for this class was generated from the following file:

/builddir/build/BUILD/libtins-4.5/include/tins/hw_address.h

Public Types

Public Member Functions

Static Public Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ HWAddress() [1/4]

◆ HWAddress() [2/4]

◆ HWAddress() [3/4]

◆ HWAddress() [4/4]

Member Function Documentation

◆ begin() [1/2]

◆ begin() [2/2]

◆ copy()

◆ end() [1/2]

◆ end() [2/2]

◆ operator!=()

◆ operator&()

◆ operator<()

◆ operator<=()

◆ operator==()

◆ operator>()

◆ operator>=()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ operator|()

◆ operator~()

◆ size()

◆ to_string()

Friends And Related Symbol Documentation

◆ operator<<