QHostInfo¶

The QHostInfo class provides static functions for host name lookups. More…

Synopsis¶

Functions¶

def addresses ()
def error ()
def errorString ()
def hostName ()
def lookupHost (arg__1, arg__2)
def lookupId ()
def setAddresses (addresses)
def setError (error)
def setErrorString (errorString)
def setHostName (name)
def setLookupId (id)
def swap (other)

Static functions¶

def abortHostLookup (lookupId)
def fromName (name)
def localDomainName ()
def localHostName ()
def lookupHost (name, receiver, member)

Detailed Description¶

QHostInfo finds the IP address(es) associated with a host name, or the host name associated with an IP address. The class provides two static convenience functions: one that works asynchronously and emits a signal once the host is found, and one that blocks and returns a QHostInfo object.

To look up a host’s IP addresses asynchronously, call lookupHost() , which takes the host name or IP address, a receiver object, and a slot signature as arguments and returns an ID. You can abort the lookup by calling abortHostLookup() with the lookup ID.

Example:

# To find the IP address of qt-project.org
QHostInfo.lookupHost("qt-project.org",
                      self, SLOT(printResults(QHostInfo)))
# To find the host name for 4.2.2.1
QHostInfo.lookupHost("4.2.2.1",
                      self, SLOT(printResults(QHostInfo)))

The slot is invoked when the results are ready. The results are stored in a QHostInfo object. Call addresses() to get the list of IP addresses for the host, and hostName() to get the host name that was looked up.

If the lookup failed, error() returns the type of error that occurred. errorString() gives a human-readable description of the lookup error.

If you want a blocking lookup, use the fromName() function:

info = QHostInfo.fromName("qt-project.org")

QHostInfo supports Internationalized Domain Names (IDNs) through the IDNA and Punycode standards.

To retrieve the name of the local host, use the static function.

QHostInfo uses the mechanisms provided by the operating system to perform the lookup. As per {https://tools.ietf.org/html/rfc6724}{RFC 6724} there is no guarantee that all IP addresses registered for a domain or host will be returned.

Note

Since Qt 4.6.1 QHostInfo is using multiple threads for DNS lookup instead of one dedicated DNS thread. This improves performance, but also changes the order of signal emissions when using lookupHost() compared to previous versions of Qt.

Note

Since Qt 4.6.3 QHostInfo is using a small internal 60 second DNS cache for performance improvements.

See also

setAddresses() hostName() error()

PySide6.QtNetwork.QHostInfo.error()¶

Return type: HostInfoError

Returns the type of error that occurred if the host name lookup failed; otherwise returns NoError .

See also

setError() errorString()

PySide6.QtNetwork.QHostInfo.errorString()¶

Return type: str

If the lookup failed, this function returns a human readable description of the error; otherwise “Unknown error” is returned.

See also

setErrorString() error()

static PySide6.QtNetwork.QHostInfo.fromName(name)¶

Parameters: name – str
Return type: PySide6.QtNetwork.QHostInfo

Looks up the IP address(es) for the given host name. The function blocks during the lookup which means that execution of the program is suspended until the results of the lookup are ready. Returns the result of the lookup in a QHostInfo object.

If you pass a literal IP address to name instead of a host name, QHostInfo will search for the domain name for the IP (i.e., QHostInfo will perform a reverse lookup). On success, the returned QHostInfo will contain both the resolved domain name and IP addresses for the host name.

See also

lookupHost()

PySide6.QtNetwork.QHostInfo.hostName()¶

Return type: str

Returns the name of the host whose IP addresses were looked up.

See also

setHostName() localHostName()

static PySide6.QtNetwork.QHostInfo.localDomainName()¶

Return type: str

static PySide6.QtNetwork.QHostInfo.localHostName()¶

Return type: str

PySide6.QtNetwork.QHostInfo.lookupHost(arg__1, arg__2)¶

Parameters

arg__1 – str
arg__2 – PyCallable

static PySide6.QtNetwork.QHostInfo.lookupHost(name, receiver, member)

Parameters

name – str
receiver – PySide6.QtCore.QObject
member – str

Return type

int

Looks up the IP address(es) associated with host name name, and returns an ID for the lookup. When the result of the lookup is ready, the slot or signal member in receiver is called with a QHostInfo argument. The QHostInfo object can then be inspected to get the results of the lookup.

The lookup is performed by a single function call, for example:

QHostInfo.lookupHost("www.kde.org",
                      self, SLOT(lookedUp(QHostInfo)))

The implementation of the slot prints basic information about the addresses returned by the lookup, or reports an error if it failed:

def lookedUp(self, host):

    if host.error() != QHostInfo.NoError:
        print("Lookup failed:", host.errorString())
        return

    addresses = host.addresses()
    for address in addresses:
        print("Found address:", address.toString())

If you pass a literal IP address to name instead of a host name, QHostInfo will search for the domain name for the IP (i.e., QHostInfo will perform a reverse lookup). On success, the resulting QHostInfo will contain both the resolved domain name and IP addresses for the host name. Example:

QHostInfo.lookupHost("4.2.2.1",
                      self, SLOT(lookedUp(QHostInfo)))

Note

There is no guarantee on the order the signals will be emitted if you start multiple requests with .

Constant	Description
QHostInfo.NoError	The lookup was successful.
QHostInfo.HostNotFound	No IP addresses were found for the host.
QHostInfo.UnknownError	An unknown error occurred.

Qt Documentation

Table of Contents

Previous topic

Next topic

QHostInfo¶

Synopsis¶

Functions¶

Static functions¶

Detailed Description¶