A generic representation of an IP address, IPv4 or IPv6. More...

#include <tsIPAddress.h>

Inheritance diagram for ts::IPAddress:

[legend]

Collaboration diagram for ts::IPAddress:

[legend]

Classes
class	IncompatibleIPAddress
	This exception is thrown when assigning incompatible IP addresses. More...

Public Types
using	Port = uint16_t
	The concept of port is used by TCP and UDP over IP networks.

Public Member Functions
	IPAddress ()=default
	Default constructor with no initial value.

	IPAddress (const ::in6_addr &a, bool bound=false)
	IPv6 constructor from a system "struct in6_addr" structure (IPv6 socket API).

	IPAddress (const ::in_addr &a, bool bound=false)
	IPv4 constructor from a system "struct in_addr" structure (IPv4 socket API).

	IPAddress (const ::sockaddr &a)
	Generic constructor from a system "struct sockaddr" structure (IPv4 or IPv6).

	IPAddress (const ::sockaddr_in &a, bool bound=false)
	IPv4 constructor from a system "struct sockaddr_in" structure (IPv4 socket API).

	IPAddress (const ::sockaddr_in6 &a, bool bound=false)
	IPv6 constructor from a system "struct sockaddr_in6" structure (IPv6 socket API).

	IPAddress (const ::sockaddr_storage &a)
	Generic constructor from a system "struct sockaddr_storage" structure (IPv4 or IPv6).

	IPAddress (const ByteBlock &bb, bool bound=false)
	Generic constructor from an address in binary format.

	IPAddress (const IPAddress &other)
	Copy constructor.

	IPAddress (const uint8_t *addr, size_t size, bool bound=false)
	Generic constructor from an address in binary format.

	IPAddress (const UString &name, Report &report, IP bound=IP::Any)
	Constructor from a string, host name or integer format.

	IPAddress (IP bound)
	Constructor with no initial value but optionally bound to a generation.

	IPAddress (uint16_t h1, uint16_t h2, uint16_t h3, uint16_t h4, uint16_t h5, uint16_t h6, uint16_t h7, uint16_t h8, bool bound=false)
	IPv6 constructor of an IPv6 address from 8 hexlets.

	IPAddress (uint32_t addr, bool bound=false)
	IPv4 constructor from an integer IPv4 address.

	IPAddress (uint64_t net, uint64_t ifid, bool bound=false)
	IPv6 constructor of an IPv6 address from network prefix and interface identifier.

	IPAddress (uint8_t b1, uint8_t b2, uint8_t b3, uint8_t b4, bool bound=false)
	IPv4 constructor from 4 bytes (classical IPv4 notation).

virtual	~IPAddress () override
	Destructor.

uint32_t	address4 () const
	Get the IPv4 address as a 32-bit integer value in host byte order.

ByteBlock	address6 () const
	Get the IPv6 address as a byte block.

virtual size_t	binarySize () const override
	Get the maximum binary size in bytes for an address of that class.

IP	boundGeneration () const
	Get the generation of IP addresses this instance is bound to.

void	checkCompatibility (const IPAddress &other)
	Check if this object can hold a value of a specific IP generation and throw an exception if not.

void	checkCompatibility (IP gen)
	Check if this object can hold a value of a specific IP generation and throw an exception if not.

virtual void	clear ()
	Clear the object, address and port if there is any.

virtual void	clearAddress () override
	Clear the address field.

virtual void	clearPort ()
	Clear the port.

bool	convert (IP gen)
	Convert an IP address to another generation, when possible.

virtual const UChar *	familyName () const override
	Get a human-readable family name for an address of that class.

IP	generation () const
	Get the current generation of IP addresses.

size_t	getAddress (::sockaddr_storage *a, size_t size, Port port) const
	Copy the address into a system "struct sockaddr_storage" structure (socket API).

virtual size_t	getAddress (void *addr, size_t size) const override
	Get the network address as binary data.

void	getAddress4 (::in_addr &a) const
	Copy the IPv4 address into a system "struct in_addr" structure (socket API).

void	getAddress4 (::sockaddr_in &a, Port port) const
	Copy the IPv4 address into a system "struct sockaddr_in" structure (socket API).

void	getAddress6 (::in6_addr &a) const
	Copy the IPv6 address into a system "struct in6_addr" structure (socket API).

void	getAddress6 (::sockaddr_in6 &a, Port port) const
	Copy the IPv6 address into a system "struct sockaddr_in6" structure (socket API).

virtual bool	hasAddress () const override
	Check if this object is set to a valid address.

virtual bool	hasPort () const
	Check if a port is set.

uint16_t	hexlet6 (size_t i) const
	Get one of the 16-bit hexlets in the IPv6 address.

uint64_t	interfaceIdentifier6 () const
	Get the IPv6 interface identifier (64 least significant bits) of the IPv6 address.

bool	isBound () const
	Check if the address is bound to a specific generation of IP addresses.

bool	isCompatible (const IPAddress &other)
	Check if this object can hold a value of a specific IP generation.

bool	isCompatible (IP gen)
	Check if this object can hold a value of a specific IP generation.

bool	isIPv4Mapped () const
	Check if the address is an IPv6 address which is mapped to an IPv4 one.

virtual bool	isMulticast () const override
	Check if the address is a multicast address.

bool	isSSM () const
	Check if the address is a source specific multicast (SSM) address.

bool	match (const IPAddress &other) const
	Check if this address "matches" another one.

uint64_t	networkPrefix6 () const
	Get the IPv6 network prefix (64 most significant bits) of the IPv6 address.

bool	operator< (const IPAddress &other) const
	Comparison "less than" operator.

IPAddress &	operator= (const IPAddress &other)
	Assignment operator.

bool	operator== (const IPAddress &other) const
	Equality operator.

virtual Port	port () const
	Get the port if there is one.

virtual bool	resolve (const UString &name, Report &report) override
	Decode a string containing a network address in family-specific format.

void	setAddress (const ::sockaddr &a)
	Set the IP address from a system "struct sockaddr" structure (IPv4 or IPv6).

void	setAddress (const ::sockaddr_storage &a)
	Set the IP address from a system "struct sockaddr_storage" structure (IPv4 or IPv6).

void	setAddress (const IPAddress &other)
	Set the IP address from another IPAddress object.

virtual bool	setAddress (const void *addr, size_t size) override
	Set the network address from binary data.

void	setAddress4 (const ::in_addr &a)
	Set the IPv4 address from a system "struct in_addr" structure.

void	setAddress4 (const ::sockaddr_in &a)
	Set the IPv4 address from a system "struct sockaddr_in" structure.

void	setAddress4 (uint32_t addr)
	Set the IP address from an IPv4 address as a 32-bit integer value in host byte order.

void	setAddress4 (uint8_t b1, uint8_t b2, uint8_t b3, uint8_t b4)
	Set the IP address from 4 bytes (classical IPv4 notation).

void	setAddress6 (const ::in6_addr &a)
	Set the IPv6 address from a system "struct in6_addr" structure.

void	setAddress6 (const ::sockaddr_in6 &a)
	Set the IPv6 address from a system "struct sockaddr_in6" structure.

void	setAddress6 (uint16_t h1, uint16_t h2, uint16_t h3, uint16_t h4, uint16_t h5, uint16_t h6, uint16_t h7, uint16_t h8)
	Set the IP address from an IPv6 address as 8 hexlets.

void	setAddress6 (uint64_t net, uint64_t ifid)
	Set the IP address from an IPv6 address as network prefix and interface identifier.

virtual void	setPort (Port port)
	Set the port.

virtual UString	toFullString () const override
	Convert to a string object in numeric format without the default compaction.

virtual UString	toString () const override
	Convert to a string object.

Static Public Member Functions
static size_t	AddressBits (IP gen)
	Get the address size in bits for a given generation of IP protocols.

static const IPAddress &	AnyAddress (IP gen)
	Get the "any address" template for a given generation of IP protocols.

static const IPAddress &	LocalHost (IP gen)
	Get the "local host" address for a given generation of IP protocols.

static bool	ResolveAllAddresses (IPAddressVector &addresses, const UString &name, Report &report, IP gen=IP::Any)
	Decode a host name and get all possible addresses for that host.

Static Public Attributes
static const IPAddress	AnyAddress4
	Wildcard value for "any IPv4 address".

static const IPAddress	AnyAddress6
	Wildcard value for "any IPv6 address".

static constexpr Port	AnyPort = 0
	Wildcard integer value for "any port" or "no port".

static constexpr size_t	BITS4 = 32
	Size in bits of an IPv4 address.

static constexpr size_t	BITS6 = 128
	Size in bits of an IPv6 address.

static constexpr size_t	BYTES4 = 4
	Size in bytes of an IPv4 address.

static constexpr size_t	BYTES6 = 16
	Size in bytes of an IPv6 address.

static const IPAddress	LocalHost4
	Local host IPv4 address ("localhost").

static const IPAddress	LocalHost6
	Local host IPv6 address (::1, "localhost").

Detailed Description

A generic representation of an IP address, IPv4 or IPv6.

See also: https://en.wikipedia.org/wiki/IPv6_address

An instance of this class can hold an IPv4 or an IPv6 address.

An instance can optionally be bound by construction to a given generation. If it is bound to a given generation, trying to assign an address of a different generation will throw an exception.

An instance always have a generation IPv4 or IPv6. The default initial value is the IPv4 generic address for "any address".

In this class, methods which apply to only one generation, IPv4 or IPv6, have a name ending in 4 or 6, respectively. Some constructors implicitly build one generation of address, IPv4 or IPv6, but their names remain IPAddress() without trailing 4 or 6 by design of C++.

IP v4 addresses are sometimes manipulated as 32-bit integer values. There is always some ambiguity in the operating system interface about the byte order of these integer values. In this class, all publicly available integer values are in the natural host byte order. Whenever a conversion is required, the internal guts of this class will do it for you (and hide it from you).

An IPv6 address is made of 128 bits (16 bytes). It can be manipulated as

16 bytes
8 groups of 16 bits or hextets.
2 64-bit values, the network prefix and the network identifier.

Constructor & Destructor Documentation

◆ IPAddress() [1/16]

ts::IPAddress::IPAddress ( )

default

Default constructor with no initial value.

The default initial value is AnyAddress4.

◆ IPAddress() [2/16]

ts::IPAddress::IPAddress ( IP bound )

Constructor with no initial value but optionally bound to a generation.

The default initial value is AnyAddress4, unless bound is IP::v6 in which case the default initial value is AnyAddress6.

Parameters

[in] bound Bound generation of the IP address. When set to IP::Any, this instance can receive any generation of IP address. Otherwise, this instance can only receive addresses of the specified generation. In that case, trying to assign an address from a different generation thows the exception IncompatibleIPAddress.

◆ IPAddress() [3/16]

ts::IPAddress::IPAddress ( const IPAddress & other )

Copy constructor.

Parameters

[in] other Another instance to copy. If other is bound to an IP generation, this object is bound to the same generation.

◆ IPAddress() [4/16]

ts::IPAddress::IPAddress	(	const uint8_t *	addr,
		size_t	size,
		bool	bound = `false`
	)

Generic constructor from an address in binary format.

Parameters

[in]	addr	Address of the memory area containing the address in binary format.
[in]	size	Size of the memory area. If the size is 4, this is an IPv4 address. If the size is 16, this is an IPv6 address. For all other sizes, the address is AnyAddress4.
[in]	bound	If true, this instance is bound to it generation. Otherwise, it can receive any address.

◆ IPAddress() [5/16]

ts::IPAddress::IPAddress	(	const ByteBlock &	bb,
		bool	bound = `false`
	)

inline

Generic constructor from an address in binary format.

Parameters

[in]	bb	Byte block containing the address in binary format. If the size is 4, this is an IPv4 address. If the size is 16, this is an IPv6 address. For all other sizes, the address is AnyAddress4.
[in]	bound	If true, this instance is bound to it generation. Otherwise, it can receive any address.

◆ IPAddress() [6/16]

ts::IPAddress::IPAddress	(	uint32_t	addr,
		bool	bound = `false`
	)

IPv4 constructor from an integer IPv4 address.

Parameters

[in]	addr	The IP v4 address as an integer in host byte order.
[in]	bound	If true, this instance is bound to IPv4. Otherwise, it can receive any address.

◆ IPAddress() [7/16]

ts::IPAddress::IPAddress	(	uint8_t	b1,
		uint8_t	b2,
		uint8_t	b3,
		uint8_t	b4,
		bool	bound = `false`
	)

IPv4 constructor from 4 bytes (classical IPv4 notation).

Parameters

[in]	b1	First address byte.
[in]	b2	Second address byte.
[in]	b3	Third address byte.
[in]	b4	Fourth address byte.
[in]	bound	If true, this instance is bound to IPv4. Otherwise, it can receive any address.

◆ IPAddress() [8/16]

ts::IPAddress::IPAddress	(	uint16_t	h1,
		uint16_t	h2,
		uint16_t	h3,
		uint16_t	h4,
		uint16_t	h5,
		uint16_t	h6,
		uint16_t	h7,
		uint16_t	h8,
		bool	bound = `false`
	)

IPv6 constructor of an IPv6 address from 8 hexlets.

Parameters

[in]	h1	First address hexlet.
[in]	h2	2nd address hexlet.
[in]	h3	3rd address hexlet.
[in]	h4	4th address hexlet.
[in]	h5	5th address hexlet.
[in]	h6	6th address hexlet.
[in]	h7	7th address hexlet.
[in]	h8	8th address hexlet.
[in]	bound	If true, this instance is bound to IPv6. Otherwise, it can receive any address.

◆ IPAddress() [9/16]

ts::IPAddress::IPAddress	(	uint64_t	net,
		uint64_t	ifid,
		bool	bound = `false`
	)

IPv6 constructor of an IPv6 address from network prefix and interface identifier.

Parameters

[in]	net	Network prefix.
[in]	ifid	Interface identifier.
[in]	bound	If true, this instance is bound to IPv6. Otherwise, it can receive any address.

◆ IPAddress() [10/16]

ts::IPAddress::IPAddress ( const ::sockaddr & a )

Generic constructor from a system "struct sockaddr" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr" structure. Note: the structure "sockaddr" is deprecated because it cannot hold an IPv6 socket address. The structure "sockaddr_storage" should be used instead.

◆ IPAddress() [11/16]

ts::IPAddress::IPAddress ( const ::sockaddr_storage & a )

inline

Generic constructor from a system "struct sockaddr_storage" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr_storage" structure.

◆ IPAddress() [12/16]

ts::IPAddress::IPAddress	(	const ::in_addr &	a,
		bool	bound = `false`
	)

IPv4 constructor from a system "struct in_addr" structure (IPv4 socket API).

Parameters

[in]	a	A system "struct in_addr" structure.
[in]	bound	If true, this instance is bound to IPv4. Otherwise, it can receive any address.

◆ IPAddress() [13/16]

ts::IPAddress::IPAddress	(	const ::sockaddr_in &	a,
		bool	bound = `false`
	)

IPv4 constructor from a system "struct sockaddr_in" structure (IPv4 socket API).

Parameters

[in]	a	A system "struct sockaddr_in" structure.
[in]	bound	If true, this instance is bound to IPv4. Otherwise, it can receive any address.

◆ IPAddress() [14/16]

ts::IPAddress::IPAddress	(	const ::in6_addr &	a,
		bool	bound = `false`
	)

IPv6 constructor from a system "struct in6_addr" structure (IPv6 socket API).

Parameters

[in]	a	A system "struct in6_addr" structure.
[in]	bound	If true, this instance is bound to IPv6. Otherwise, it can receive any address.

◆ IPAddress() [15/16]

ts::IPAddress::IPAddress	(	const ::sockaddr_in6 &	a,
		bool	bound = `false`
	)

IPv6 constructor from a system "struct sockaddr_in6" structure (IPv6 socket API).

Parameters

[in]	a	A system "struct sockaddr_in6" structure.
[in]	bound	If true, this instance is bound to IPv6. Otherwise, it can receive any address.

◆ IPAddress() [16/16]

ts::IPAddress::IPAddress	(	const UString &	name,
		Report &	report,
		IP	bound = `IP::Any`
	)

inline

Constructor from a string, host name or integer format.

If name cannot be resolved, the address is set to AnyAddress4.

Parameters

[in]	name	A string containing either a host name or a numerical representation of the address.
[in]	report	Where to report errors.
[in]	bound	Bound generation of the IP address. If not set to IP::Any (the default), this instance becomes bound to that IP generation and the name resolution can only produce an address of that generation.

Member Function Documentation

◆ AnyAddress()

static const IPAddress & ts::IPAddress::AnyAddress ( IP gen )

inlinestatic

Get the "any address" template for a given generation of IP protocols.

Parameters

[in] gen Generation of IP protocols.

Returns: A constant reference to the corresponding "any address".

◆ LocalHost()

static const IPAddress & ts::IPAddress::LocalHost ( IP gen )

inlinestatic

Get the "local host" address for a given generation of IP protocols.

Parameters

[in] gen Generation of IP protocols.

Returns: A constant reference to the corresponding "local host" address.

◆ AddressBits()

static size_t ts::IPAddress::AddressBits ( IP gen )

inlinestatic

Get the address size in bits for a given generation of IP protocols.

Parameters

[in] gen Generation of IP protocols.

Returns: Address size in bits.

◆ operator=()

IPAddress & ts::IPAddress::operator= ( const IPAddress & other )

Assignment operator.

The binding of this object to an IP generation is not changed.

Parameters

[in] other Another instance to copy.

Returns: Reference to this object.

◆ operator==()

bool ts::IPAddress::operator== ( const IPAddress & other ) const

Equality operator.

Parameters

[in] other Another instance to compare with.

Returns: True if both object contains the same address, false otherwise.

◆ operator<()

bool ts::IPAddress::operator< ( const IPAddress & other ) const

Comparison "less than" operator.

It does not really makes sense. Only defined to allow usage in containers.

Parameters

[in] other Other instance to compare.

Returns: True if this instance is less than to other.

◆ match()

bool ts::IPAddress::match ( const IPAddress & other ) const

Check if this address "matches" another one.

Parameters

[in] other Another instance to compare.

Returns: False if this and other addresses are both specified and are different. True otherwise.

◆ generation()

IP ts::IPAddress::generation ( ) const

inline

Get the current generation of IP addresses.

Returns: The IP generation of the address currently in this instance. Never IP::Any.

◆ isBound()

bool ts::IPAddress::isBound ( ) const

inline

Check if the address is bound to a specific generation of IP addresses.

Returns: True if the address is bound to a specific generation of IP addresses.

◆ boundGeneration()

IP ts::IPAddress::boundGeneration ( ) const

inline

Get the generation of IP addresses this instance is bound to.

Returns: The generation of IP addresses this instance is bound to. Return IP::Any if this instance is not bound to a generation.

◆ isCompatible() [1/2]

bool ts::IPAddress::isCompatible ( IP gen )

inline

Check if this object can hold a value of a specific IP generation.

Parameters

[in] gen The IP generation to check.

Returns: True if this object is not bound to another IP generation.

◆ isCompatible() [2/2]

bool ts::IPAddress::isCompatible ( const IPAddress & other )

inline

Check if this object can hold a value of a specific IP generation.

Parameters

[in] other Another IP to check.

Returns: True if this object is not bound to an IP generation other than the current generation of other.

◆ checkCompatibility() [1/2]

void ts::IPAddress::checkCompatibility ( IP gen )

Check if this object can hold a value of a specific IP generation and throw an exception if not.

Parameters

[in] gen The IP generation to check.

Exceptions

IncompatibleIPAddress when this object is bound to another IP generation.

◆ checkCompatibility() [2/2]

void ts::IPAddress::checkCompatibility ( const IPAddress & other )

inline

Check if this object can hold a value of a specific IP generation and throw an exception if not.

Parameters

[in] other Another IP to check.

Exceptions

IncompatibleIPAddress when this object is bound to an IP generation other than the current generation of other.

◆ isIPv4Mapped()

bool ts::IPAddress::isIPv4Mapped ( ) const

Check if the address is an IPv6 address which is mapped to an IPv4 one.

Returns: true if the address is an IPv6 address which is mapped to an IPv4 one.

◆ convert()

bool ts::IPAddress::convert ( IP gen )

Convert an IP address to another generation, when possible.

Parameters

[in] gen New IP generation to apply. If gen is incompatible with the object (bound to another generation), return false. If gen is IP::Any or the same as the current generation, return true. A conversion from IPv4 to IPv6 always works (IPv4-mapped address). The conversion of an IPv6 address is only possible if it is an IPv4-mapped address. For convenience, the IPv4 and IPv6 loopback addressses are converted to each other.

Returns: True if the conversion was successful, false if the conversion was no possible.

◆ binarySize()

virtual size_t ts::IPAddress::binarySize ( ) const

overridevirtual

Get the maximum binary size in bytes for an address of that class.

Returns: The maximum binary size in bytes for an address of that class.

Implements ts::AbstractNetworkAddress.

◆ familyName()

virtual const UChar * ts::IPAddress::familyName ( ) const

overridevirtual

Get a human-readable family name for an address of that class.

This is typically something like "IPv4" or "IPv6".

Returns: A human-readable family name for an address of that class.

Implements ts::AbstractNetworkAddress.

◆ hasAddress()

virtual bool ts::IPAddress::hasAddress ( ) const

overridevirtual

Check if this object is set to a valid address.

Returns: True if this object is set to a valid address, false otherwise.

Implements ts::AbstractNetworkAddress.

◆ getAddress() [1/2]

virtual size_t ts::IPAddress::getAddress	(	void *	addr,
		size_t	size
	)		const

overridevirtual

Get the network address as binary data.

Parameters

[out]	addr	Address of binary buffer to receive binary data.
[in]	size	Size in bytes of buffer.

Returns: Number of copied bytes on success, zero on error (data too short).

Implements ts::AbstractNetworkAddress.

◆ setAddress() [1/4]

virtual bool ts::IPAddress::setAddress	(	const void *	addr,
		size_t	size
	)

overridevirtual

Set the network address from binary data.

Parameters

[in]	addr	Address of binary data.
[in]	size	Size in bytes of binary data.

Returns: True on success, false on error (data too short).

Implements ts::AbstractNetworkAddress.

◆ clearAddress()

virtual void ts::IPAddress::clearAddress ( )

overridevirtual

Clear the address field.

Implements ts::AbstractNetworkAddress.

◆ isMulticast()

virtual bool ts::IPAddress::isMulticast ( ) const

overridevirtual

Check if the address is a multicast address.

Returns: True if the address is a multicast address, false otherwise.

Implements ts::AbstractNetworkAddress.

◆ resolve()

virtual bool ts::IPAddress::resolve	(	const UString &	name,
		Report &	report
	)

overridevirtual

Decode a string containing a network address in family-specific format.

Parameters

[in]	name	A string containing either a host name or a numerical representation of the address.
[in]	report	Where to report errors.

Returns: True if name was successfully resolved, false otherwise. In the later case, the address is invalidated.

Implements ts::AbstractNetworkAddress.

Reimplemented in ts::IPSocketAddress.

◆ toFullString()

virtual UString ts::IPAddress::toFullString ( ) const

overridevirtual

Convert to a string object in numeric format without the default compaction.

The method toString() (inherited from StringifyInterface) returns a default representation of the string, with possible compaction of omitted defaults. This method returns a complete version of the address representation. The default implementation returns the same value as toString().

Returns: This object, converted as a string.

Reimplemented from ts::AbstractNetworkAddress.

Reimplemented in ts::IPAddressMask, and ts::IPSocketAddress.

◆ toString()

virtual UString ts::IPAddress::toString ( ) const

overridevirtual

Convert to a string object.

Returns: This object, converted as a string.

Implements ts::StringifyInterface.

Reimplemented in ts::IPAddressMask, and ts::IPSocketAddress.

◆ isSSM()

bool ts::IPAddress::isSSM ( ) const

Check if the address is a source specific multicast (SSM) address.

Returns: True if the address is an SSM address, false otherwise.

◆ address4()

uint32_t ts::IPAddress::address4 ( ) const

inline

Get the IPv4 address as a 32-bit integer value in host byte order.

Returns: The IPv4 address as a 32-bit integer value in host byte order or zero if not an IPv4 address.

◆ address6()

ByteBlock ts::IPAddress::address6 ( ) const

Get the IPv6 address as a byte block.

Returns: Byte block containing the IPv6 bytes.

◆ networkPrefix6()

uint64_t ts::IPAddress::networkPrefix6 ( ) const

Get the IPv6 network prefix (64 most significant bits) of the IPv6 address.

Returns: The network prefix (64 most significant bits) of the IPv6 address.

◆ interfaceIdentifier6()

uint64_t ts::IPAddress::interfaceIdentifier6 ( ) const

Get the IPv6 interface identifier (64 least significant bits) of the IPv6 address.

Returns: The interface identifier (64 least significant bits) of the IPv6 address.

◆ hexlet6()

uint16_t ts::IPAddress::hexlet6 ( size_t i ) const

Get one of the 16-bit hexlets in the IPv6 address.

Parameters

[in] i Hexlet index, from 0 to 7.

Returns: The corresponding hexlet or zero if i is out of range.

◆ setAddress() [2/4]

void ts::IPAddress::setAddress ( const IPAddress & other )

Set the IP address from another IPAddress object.

Useful for subclasses to assign the address part only.

Parameters

[in] other Another IP address.

◆ setAddress4() [1/4]

void ts::IPAddress::setAddress4 ( uint32_t addr )

Set the IP address from an IPv4 address as a 32-bit integer value in host byte order.

Parameters

[in] addr The IP v4 address as an integer in host byte order.

◆ setAddress4() [2/4]

void ts::IPAddress::setAddress4	(	uint8_t	b1,
		uint8_t	b2,
		uint8_t	b3,
		uint8_t	b4
	)

Set the IP address from 4 bytes (classical IPv4 notation).

Parameters

[in]	b1	First address byte.
[in]	b2	Second address byte.
[in]	b3	Third address byte.
[in]	b4	Fourth address byte.

◆ setAddress6() [1/4]

void ts::IPAddress::setAddress6	(	uint16_t	h1,
		uint16_t	h2,
		uint16_t	h3,
		uint16_t	h4,
		uint16_t	h5,
		uint16_t	h6,
		uint16_t	h7,
		uint16_t	h8
	)

Set the IP address from an IPv6 address as 8 hexlets.

Parameters

[in]	h1	First address hexlet.
[in]	h2	2nd address hexlet.
[in]	h3	3rd address hexlet.
[in]	h4	4th address hexlet.
[in]	h5	5th address hexlet.
[in]	h6	6th address hexlet.
[in]	h7	7th address hexlet.
[in]	h8	8th address hexlet.

◆ setAddress6() [2/4]

void ts::IPAddress::setAddress6	(	uint64_t	net,
		uint64_t	ifid
	)

Set the IP address from an IPv6 address as network prefix and interface identifier.

Parameters

[in]	net	Network prefix.
[in]	ifid	Interface identifier.

◆ setAddress() [3/4]

void ts::IPAddress::setAddress ( const ::sockaddr & a )

Set the IP address from a system "struct sockaddr" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr" structure. Note: the structure "sockaddr" is deprecated because it cannot hold an IPv6 socket address. The structure "sockaddr_storage" should be used instead.

◆ setAddress() [4/4]

void ts::IPAddress::setAddress ( const ::sockaddr_storage & a )

inline

Set the IP address from a system "struct sockaddr_storage" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr_storage" structure.

◆ setAddress4() [3/4]

void ts::IPAddress::setAddress4 ( const ::in_addr & a )

Set the IPv4 address from a system "struct in_addr" structure.

Parameters

[in] a A system "struct in_addr" structure.

◆ setAddress4() [4/4]

void ts::IPAddress::setAddress4 ( const ::sockaddr_in & a )

Set the IPv4 address from a system "struct sockaddr_in" structure.

Parameters

[in] a A system "struct sockaddr_in" structure.

◆ setAddress6() [3/4]

void ts::IPAddress::setAddress6 ( const ::in6_addr & a )

Set the IPv6 address from a system "struct in6_addr" structure.

Parameters

[in] a A system "struct in6_addr" structure.

◆ setAddress6() [4/4]

void ts::IPAddress::setAddress6 ( const ::sockaddr_in6 & a )

Set the IPv6 address from a system "struct sockaddr_in6" structure.

Parameters

[in] a A system "struct sockaddr_in6" structure.

◆ getAddress() [2/2]

size_t ts::IPAddress::getAddress	(	::sockaddr_storage *	a,
		size_t	size,
		Port	port
	)		const

Copy the address into a system "struct sockaddr_storage" structure (socket API).

Note: the structure "sockaddr" is deprecated because it cannot hold an IPv6 socket address. The structure "sockaddr_storage" should be used instead.

Parameters

[out]	a	Address of a system socket address structure.
[in]	size	Size in bytes of the system socket address structure.
[in]	port	Port number for the socket address.

Returns: Actual number of bytes used in the structure "sockaddr_storage", zero on error (system socket address structure is too small).

◆ getAddress4() [1/2]

void ts::IPAddress::getAddress4	(	::sockaddr_in &	a,
		Port	port
	)		const

Copy the IPv4 address into a system "struct sockaddr_in" structure (socket API).

Parameters

[out]	a	A system "struct sockaddr_in" structure.
[in]	port	Port number for the socket address.

◆ getAddress4() [2/2]

void ts::IPAddress::getAddress4 ( ::in_addr & a ) const

Copy the IPv4 address into a system "struct in_addr" structure (socket API).

Parameters

[out] a A system "struct in_addr" structure.

◆ getAddress6() [1/2]

void ts::IPAddress::getAddress6	(	::sockaddr_in6 &	a,
		Port	port
	)		const

Copy the IPv6 address into a system "struct sockaddr_in6" structure (socket API).

Parameters

[out]	a	A system "struct sockaddr_in6" structure.
[in]	port	Port number for the socket address.

◆ getAddress6() [2/2]

void ts::IPAddress::getAddress6 ( ::in6_addr & a ) const

Copy the IPv6 address into a system "struct in6_addr" structure (socket API).

Parameters

[out] a A system "struct in6_addr" structure.

◆ ResolveAllAddresses()

static bool ts::IPAddress::ResolveAllAddresses	(	IPAddressVector &	addresses,
		const UString &	name,
		Report &	report,
		IP	gen = `IP::Any`
	)

static

Decode a host name and get all possible addresses for that host.

Parameters

[out]	addresses	List of possible addresses for name. If name is a valid numerical addresse, only this one is returned.
[in]	name	A string containing either a host name or a numerical representation of the address.
[in,out]	report	Where to report errors.
[in]	gen	IP generation of the returned address. Can be used to restrict the result to IPv4 or IPv6 addresses. Return all by default.

Returns: True if name was successfully resolved, false otherwise.

◆ hasPort()

virtual bool ts::AbstractNetworkAddress::hasPort ( ) const

virtualinherited

Check if a port is set.

Returns: True if port is set.

◆ port()

virtual Port ts::AbstractNetworkAddress::port ( ) const

virtualinherited

Get the port if there is one.

The default implementation returns AnyPort.

Returns: The port number or AnyPort if there is none.

Reimplemented in ts::IPSocketAddress.

◆ setPort()

virtual void ts::AbstractNetworkAddress::setPort ( Port port )

virtualinherited

Set the port.

The default implementation does nothing.

Parameters

[in] port The port number as an integer in host byte order.

Reimplemented in ts::IPSocketAddress.

◆ clearPort()

virtual void ts::AbstractNetworkAddress::clearPort ( )

virtualinherited

Clear the port.

The default implementatio sets the port to AnyPort

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

tsIPAddress.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ IPAddress() [1/16]

◆ IPAddress() [2/16]

◆ IPAddress() [3/16]

◆ IPAddress() [4/16]

◆ IPAddress() [5/16]

◆ IPAddress() [6/16]

◆ IPAddress() [7/16]

◆ IPAddress() [8/16]

◆ IPAddress() [9/16]

◆ IPAddress() [10/16]

◆ IPAddress() [11/16]

◆ IPAddress() [12/16]

◆ IPAddress() [13/16]

◆ IPAddress() [14/16]

◆ IPAddress() [15/16]

◆ IPAddress() [16/16]

Member Function Documentation

◆ AnyAddress()

◆ LocalHost()

◆ AddressBits()

◆ operator=()

◆ operator==()

◆ operator<()

◆ match()

◆ generation()

◆ isBound()

◆ boundGeneration()

◆ isCompatible() [1/2]

◆ isCompatible() [2/2]

◆ checkCompatibility() [1/2]

◆ checkCompatibility() [2/2]

◆ isIPv4Mapped()

◆ convert()

◆ binarySize()

◆ familyName()

◆ hasAddress()

◆ getAddress() [1/2]

◆ setAddress() [1/4]

◆ clearAddress()

◆ isMulticast()

◆ resolve()

◆ toFullString()

◆ toString()

◆ isSSM()

◆ address4()

◆ address6()

◆ networkPrefix6()

◆ interfaceIdentifier6()

◆ hexlet6()

◆ setAddress() [2/4]

◆ setAddress4() [1/4]

◆ setAddress4() [2/4]

◆ setAddress6() [1/4]

◆ setAddress6() [2/4]

◆ setAddress() [3/4]

◆ setAddress() [4/4]

◆ setAddress4() [3/4]

◆ setAddress4() [4/4]

◆ setAddress6() [3/4]

◆ setAddress6() [4/4]

◆ getAddress() [2/2]

◆ getAddress4() [1/2]

◆ getAddress4() [2/2]

◆ getAddress6() [1/2]

◆ getAddress6() [2/2]

◆ ResolveAllAddresses()

◆ hasPort()

◆ port()

◆ setPort()

◆ clearPort()