CopperSpice API  1.7.2
QNetworkInterface Class Reference

The QNetworkInterface class provides a listing of the host's IP addresses and network interfaces. More...

Public Typedefs

using InterfaceFlags = QFlags< InterfaceFlag >
 

Public Types

enum  InterfaceFlag
 

Public Methods

 QNetworkInterface ()
 
 QNetworkInterface (const QNetworkInterface &other)
 
 ~QNetworkInterface ()
 
QList< QNetworkAddressEntryaddressEntries () const
 
InterfaceFlags flags () const
 
QString hardwareAddress () const
 
QString humanReadableName () const
 
int index () const
 
bool isValid () const
 
QString name () const
 
QNetworkInterface & operator= (const QNetworkInterface &other)
 
QNetworkInterface & operator= (QNetworkInterface &&other)
 
void swap (QNetworkInterface &other)
 

Static Public Methods

static QList< QHostAddressallAddresses ()
 
static QList< QNetworkInterface > allInterfaces ()
 
static QNetworkInterface interfaceFromIndex (int index)
 
static QNetworkInterface interfaceFromName (const QString &name)
 

Detailed Description

The QNetworkInterface class provides a listing of the host's IP addresses and network interfaces.

QNetworkInterface represents one network interface attached to the host where the program is being run. Each network interface may contain zero or more IP addresses, each of which is optionally associated with a netmask and/or a broadcast address. The list of such trios can be obtained with addressEntries(). Alternatively, when the netmask or the broadcast addresses are not necessary, use the allAddresses() convenience function to obtain just the IP addresses.

QNetworkInterface also reports the interface's hardware address with hardwareAddress().

Not all operating systems support reporting all features. Only the IPv4 addresses are guaranteed to be listed by this class in all platforms. In particular, IPv6 address listing is only supported on Windows XP and more recent versions, Linux, Mac OS X and the BSDs.

See also
QNetworkAddressEntry

Member Typedef Documentation

Member Enumeration Documentation

Specifies the flags associated with this network interface. One network interface can not be both CanBroadcast and IsPointToPoint.

ConstantValueDescription
QNetworkInterface::IsUp0x1the network interface is active
QNetworkInterface::IsRunning0x2the network interface has resources allocated
QNetworkInterface::CanBroadcast0x4the network interface works in broadcast mode
QNetworkInterface::IsLoopBack0x8the network interface is a loopback interface: that is, it is a virtual interface whose destination is the host computer itself
QNetworkInterface::IsPointToPoint0x10the network interface is a point-to-point interface, that is, there is one, single other address that can be directly reached by it.
QNetworkInterface::CanMulticast0x20the network interface supports multicasting

Constructor & Destructor Documentation

QNetworkInterface::QNetworkInterface ( )

Constructs an empty network interface object.

QNetworkInterface::QNetworkInterface ( const QNetworkInterface &  other)

Creates a copy of the QNetworkInterface object contained in other.

QNetworkInterface::~QNetworkInterface ( )

Destroys this QNetworkInterface.

Method Documentation

QList< QNetworkAddressEntry > QNetworkInterface::addressEntries ( ) const

Returns the list of IP addresses that this interface possesses along with their associated netmasks and broadcast addresses.

If the netmask or broadcast address information is not necessary, you can call the allAddresses() function to obtain just the IP addresses.

QList< QHostAddress > QNetworkInterface::allAddresses ( )
static

This convenience function returns all IP addresses found on the host machine. It is equivalent to calling addressEntries() on all the objects returned by allInterfaces() to obtain lists of QHostAddress objects then calling QHostAddress::ip() on each of these.

QList< QNetworkInterface > QNetworkInterface::allInterfaces ( )
static

Returns a listing of all the network interfaces found on the host machine.

InterfaceFlags QNetworkInterface::flags ( ) const

Returns the flags associated with this network interface.

QString QNetworkInterface::hardwareAddress ( ) const

Returns the low-level hardware address for this interface. On Ethernet interfaces, this will be a MAC address in string representation, separated by colons.

Other interface types may have other types of hardware addresses. Implementations should not depend on this function returning a valid MAC address.

QString QNetworkInterface::humanReadableName ( ) const

Returns the human readable name of this network interface on Windows, such as "Local Area Connection", if the name could be determined. If it could not, this function returns the same as name(). The human readable name is a name that the user can modify in the Windows Control Panel, so it may change during the execution of the program.

On Unix, this function currently always returns the same as name(), since Unix systems do not store a configuration for human readable names.

int QNetworkInterface::index ( ) const

Returns the interface system index, if known. This is an integer assigned by the operating system to identify this interface and it generally does not change. It matches the scope ID field in IPv6 addresses.

If the index is not known, this function returns 0.

QNetworkInterface QNetworkInterface::interfaceFromIndex ( int  index)
static

Returns a QNetworkInterface object for the interface whose internal ID is index. Network interfaces have a unique identifier called the "interface index" to distinguish it from other interfaces on the system. Often, this value is assigned progressively and interfaces being removed and then added again get a different value every time.

This index is also found in the IPv6 address' scope ID field.

QNetworkInterface QNetworkInterface::interfaceFromName ( const QString name)
static

Returns a QNetworkInterface object for the interface named name. If no such interface exists, this function returns an invalid QNetworkInterface object.

See also
name(), isValid()
bool QNetworkInterface::isValid ( ) const

Returns true if this QNetworkInterface object contains valid information about a network interface.

QString QNetworkInterface::name ( ) const

Returns the name of this network interface. On Unix systems, this is a string containing the type of the interface and optionally a sequence number, such as "eth0", "lo" or "pcn0". On Windows, it's an internal ID that can not be changed by the user.

QNetworkInterface & QNetworkInterface::operator= ( const QNetworkInterface &  other)

Copy assigns from other and returns a reference to this object.

QNetworkInterface & QNetworkInterface::operator= ( QNetworkInterface &&  other)
inline

Move assigns from other and returns a reference to this object.

void QNetworkInterface::swap ( QNetworkInterface &  other)
inline

Swaps other with this object. This operation is very fast and never fails.