OpenShot Library | OpenShotAudio  0.2.1
juce::IPAddress Class Referencefinal

Represents an IP address. More...

#include <juce_IPAddress.h>

Public Member Functions

 IPAddress () noexcept
 Creates a null address - 0.0.0.0 (IPv4) or ::, (IPv6)
 
 IPAddress (const uint8 *bytes, bool IPv6=false) noexcept
 Creates an IPv4 or IPv6 address by reading 4 or 16 bytes from an array. More...
 
 IPAddress (const uint16 *bytes) noexcept
 Creates an IPv6 address from an array of 8 16-bit integers. More...
 
 IPAddress (uint8 address1, uint8 address2, uint8 address3, uint8 address4) noexcept
 Creates an IPv4 address from 4 bytes. More...
 
 IPAddress (uint16 address1, uint16 address2, uint16 address3, uint16 address4, uint16 address5, uint16 address6, uint16 address7, uint16 address8) noexcept
 Creates an IPv6 address from 8 16-bit integers.
 
 IPAddress (uint32 asNativeEndian32Bit) noexcept
 Creates an IPv4 address from a packed 32-bit integer, where the MSB is the first number in the address, and the LSB is the last.
 
 IPAddress (const String &address)
 Parses a string IP address of the form "1.2.3.4" (IPv4) or "1:2:3:4:5:6:7:8" (IPv6). More...
 
bool isNull () const
 Returns whether the address contains the null address (e.g. More...
 
String toString () const
 Returns a dot- or colon-separated string in the form "1.2.3.4" (IPv4) or "1:2:3:4:5:6:7:8" (IPv6). More...
 
int compare (const IPAddress &) const noexcept
 Compares this IPAddress with another. More...
 
bool operator== (const IPAddress &) const noexcept
 
bool operator!= (const IPAddress &) const noexcept
 
bool operator< (const IPAddress &) const noexcept
 
bool operator> (const IPAddress &) const noexcept
 
bool operator<= (const IPAddress &) const noexcept
 
bool operator>= (const IPAddress &) const noexcept
 

Static Public Member Functions

static IPAddress any () noexcept
 Returns an IP address meaning "any", equivalent to 0.0.0.0 (IPv4) or ::, (IPv6)
 
static IPAddress broadcast () noexcept
 Returns an IPv4 address meaning "broadcast" (255.255.255.255)
 
static IPAddress local (bool IPv6=false) noexcept
 Returns an IPv4 or IPv6 address meaning "localhost", equivalent to 127.0.0.1 (IPv4) or ::1 (IPv6)
 
static void findAllAddresses (Array< IPAddress > &results, bool includeIPv6=false)
 Populates a list of all the IP addresses that this machine is using. More...
 
static Array< IPAddressgetAllAddresses (bool includeIPv6=false)
 Populates a list of all the IP addresses that this machine is using. More...
 
static IPAddress getLocalAddress (bool includeIPv6=false)
 Returns the first 'real' address for the local machine. More...
 
static String getFormattedAddress (const String &unformattedAddress)
 Returns a formatted version of the provided IPv6 address conforming to RFC 5952 with leading zeros suppressed, lower case characters, and double-colon notation used to represent contiguous 16-bit fields of zeros. More...
 
static bool isIPv4MappedAddress (const IPAddress &mappedAddress)
 Returns true if the given IP address is an IPv4-mapped IPv6 address. More...
 
static IPAddress convertIPv4MappedAddressToIPv4 (const IPAddress &mappedAddress)
 Converts an IPv4-mapped IPv6 address to an IPv4 address. More...
 
static IPAddress convertIPv4AddressToIPv4Mapped (const IPAddress &addressToMap)
 Converts an IPv4 address to an IPv4-mapped IPv6 address. More...
 
static IPAddress getInterfaceBroadcastAddress (const IPAddress &interfaceAddress)
 If the IPAdress is the address of an interface on the machine, returns the associated broadcast address. More...
 

Public Attributes

uint8 address [16]
 The elements of the IP address. More...
 
bool isIPv6 = false
 

Detailed Description

Represents an IP address.

Definition at line 36 of file juce_IPAddress.h.

Constructor & Destructor Documentation

◆ IPAddress() [1/4]

juce::IPAddress::IPAddress ( const uint8 *  bytes,
bool  IPv6 = false 
)
explicitnoexcept

Creates an IPv4 or IPv6 address by reading 4 or 16 bytes from an array.

Parameters
bytesThe array containing the bytes to read.
IPv6if true indicates that 16 bytes should be read instead of 4.

◆ IPAddress() [2/4]

juce::IPAddress::IPAddress ( const uint16 *  bytes)
explicitnoexcept

Creates an IPv6 address from an array of 8 16-bit integers.

Parameters
bytesThe array containing the bytes to read.

◆ IPAddress() [3/4]

juce::IPAddress::IPAddress ( uint8  address1,
uint8  address2,
uint8  address3,
uint8  address4 
)
noexcept

Creates an IPv4 address from 4 bytes.

Definition at line 67 of file juce_IPAddress.cpp.

◆ IPAddress() [4/4]

juce::IPAddress::IPAddress ( const String address)
explicit

Parses a string IP address of the form "1.2.3.4" (IPv4) or "1:2:3:4:5:6:7:8" (IPv6).

Definition at line 121 of file juce_IPAddress.cpp.

References address, juce::StringArray::fromTokens(), and juce::StringArray::indexOf().

Member Function Documentation

◆ findAllAddresses()

static void juce::IPAddress::findAllAddresses ( Array< IPAddress > &  results,
bool  includeIPv6 = false 
)
static

Populates a list of all the IP addresses that this machine is using.

Referenced by getAllAddresses().

◆ getAllAddresses()

Array< IPAddress > juce::IPAddress::getAllAddresses ( bool  includeIPv6 = false)
static

Populates a list of all the IP addresses that this machine is using.

Definition at line 368 of file juce_IPAddress.cpp.

References findAllAddresses(), getInterfaceBroadcastAddress(), isNull(), local(), and juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::size().

Referenced by juce::StreamingSocket::isLocal().

◆ getLocalAddress()

IPAddress juce::IPAddress::getLocalAddress ( bool  includeIPv6 = false)
static

Returns the first 'real' address for the local machine.

Unlike local(), this will attempt to find the machine's actual assigned address rather than "127.0.0.1". If there are multiple network cards, this may return any of their addresses. If it doesn't find any, then it'll return local() as a fallback.

Definition at line 357 of file juce_IPAddress.cpp.

Referenced by juce::NetworkServiceDiscovery::Advertiser::~Advertiser().

◆ isNull()

bool juce::IPAddress::isNull ( ) const

Returns whether the address contains the null address (e.g.

0.0.0.0).

Definition at line 101 of file juce_IPAddress.cpp.

References juce::String::containsAnyOf(), juce::String::fromFirstOccurrenceOf(), juce::String::indexOf(), juce::String::lastIndexOf(), and juce::String::upToLastOccurrenceOf().

Referenced by getAllAddresses().

◆ toString()

String juce::IPAddress::toString ( ) const

Returns a dot- or colon-separated string in the form "1.2.3.4" (IPv4) or "1:2:3:4:5:6:7:8" (IPv6).

Definition at line 177 of file juce_IPAddress.cpp.

References juce::String::toHexString().

Referenced by juce::InterprocessConnection::getConnectedHostName().

◆ compare()

int juce::IPAddress::compare ( const IPAddress other) const
noexcept

Compares this IPAddress with another.

Returns
0 if the two addresses are identical, negative if this address is smaller than the other one, or positive if is greater.

Definition at line 214 of file juce_IPAddress.cpp.

References address.

◆ getFormattedAddress()

String juce::IPAddress::getFormattedAddress ( const String unformattedAddress)
static

Returns a formatted version of the provided IPv6 address conforming to RFC 5952 with leading zeros suppressed, lower case characters, and double-colon notation used to represent contiguous 16-bit fields of zeros.

Parameters
unformattedAddressthe IPv6 address to be formatted

Definition at line 246 of file juce_IPAddress.cpp.

References juce::String::contains(), juce::String::dropLastCharacters(), juce::String::fromFirstOccurrenceOf(), juce::StringArray::fromTokens(), juce::StringArray::getReference(), juce::String::repeatedString(), and juce::String::replace().

◆ isIPv4MappedAddress()

bool juce::IPAddress::isIPv4MappedAddress ( const IPAddress mappedAddress)
static

Returns true if the given IP address is an IPv4-mapped IPv6 address.

Definition at line 320 of file juce_IPAddress.cpp.

References address.

◆ convertIPv4MappedAddressToIPv4()

IPAddress juce::IPAddress::convertIPv4MappedAddressToIPv4 ( const IPAddress mappedAddress)
static

Converts an IPv4-mapped IPv6 address to an IPv4 address.

If the address is not IPv4-mapped, this will return a null address.

Definition at line 335 of file juce_IPAddress.cpp.

References address.

◆ convertIPv4AddressToIPv4Mapped()

IPAddress juce::IPAddress::convertIPv4AddressToIPv4Mapped ( const IPAddress addressToMap)
static

Converts an IPv4 address to an IPv4-mapped IPv6 address.

Definition at line 347 of file juce_IPAddress.cpp.

References address.

◆ getInterfaceBroadcastAddress()

static IPAddress juce::IPAddress::getInterfaceBroadcastAddress ( const IPAddress interfaceAddress)
static

If the IPAdress is the address of an interface on the machine, returns the associated broadcast address.

If the address is not an interface, it will return a null address.

Referenced by getAllAddresses(), and juce::NetworkServiceDiscovery::Advertiser::~Advertiser().

Member Data Documentation

◆ address

uint8 juce::IPAddress::address[16]

The elements of the IP address.

Definition at line 117 of file juce_IPAddress.h.

Referenced by compare(), convertIPv4AddressToIPv4Mapped(), convertIPv4MappedAddressToIPv4(), IPAddress(), and isIPv4MappedAddress().


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