QHostInfo Class

Documentation des fonctions membres

[explicit] QHostInfo::QHostInfo(int id = -1)

Construit un objet host info vide avec l'ID de recherche id.

Voir aussi lookupId().

QHostInfo::QHostInfo(const QHostInfo &other)

Construit une copie de other.

[noexcept] QHostInfo::QHostInfo(QHostInfo &&other)

Move-construit un nouveau QHostInfo à partir de other.

[noexcept] QHostInfo::~QHostInfo()

Détruit l'objet host info.

[static] void QHostInfo::abortHostLookup(int id)

Abandonne la recherche d'hôte avec l'ID id, tel que renvoyé par lookupHost().

Voir aussi lookupHost() et lookupId().

QList<QHostAddress> QHostInfo::addresses() const

Renvoie la liste des adresses IP associées à hostName(). Cette liste peut être vide.

Exemple :

QHostInfo info;
...
if (!info.addresses().isEmpty()) {
    QHostAddress address = info.addresses().first();
    // use the first IP address
}

Voir aussi setAddresses(), hostName() et error().

QHostInfo::HostInfoError QHostInfo::error() const

Renvoie le type d'erreur qui s'est produite si la recherche du nom d'hôte a échoué ; sinon, renvoie NoError.

Voir aussi setError() et errorString().

QString QHostInfo::errorString() const

Si la recherche a échoué, cette fonction renvoie une description lisible de l'erreur ; sinon, elle renvoie "Erreur inconnue".

Voir également setErrorString() et error().

[static] QHostInfo QHostInfo::fromName(const QString &name)

Recherche la ou les adresses IP pour l'hôte donné name. La fonction se bloque pendant la recherche, ce qui signifie que l'exécution du programme est suspendue jusqu'à ce que les résultats de la recherche soient prêts. Renvoie le résultat de la recherche dans un objet QHostInfo.

Si vous transmettez une adresse IP littérale à name au lieu d'un nom d'hôte, QHostInfo recherchera le nom de domaine correspondant à l'IP (c'est-à-dire que QHostInfo effectuera une recherche inversée ). En cas de succès, l'adresse QHostInfo renvoyée contiendra à la fois le nom de domaine résolu et les adresses IP correspondant au nom d'hôte.

Voir aussi lookupHost().

QString QHostInfo::hostName() const

Renvoie le nom de l'hôte dont les adresses IP ont été recherchées.

Voir aussi setHostName() et localHostName().

[static] QString QHostInfo::localDomainName()

Renvoie le domaine DNS de cette machine.

Voir également hostName().

[static] QString QHostInfo::localHostName()

Renvoie le nom d'hôte de cette machine, s'il est configuré. Notez que les noms d'hôtes ne sont pas garantis comme étant globalement uniques, en particulier s'ils ont été configurés automatiquement.

Cette fonction ne garantit pas que le nom d'hôte renvoyé est un nom de domaine entièrement qualifié (FQDN). Pour cela, utilisez fromName() pour résoudre le nom retourné en un FQDN.

Cette fonction renvoie le même résultat que QSysInfo::machineHostName().

Voir également hostName() et localDomainName().

[static] int QHostInfo::lookupHost(const QString &name, const QObject *receiver, const char *member)

Recherche la ou les adresses IP associées au nom d'hôte name et renvoie un ID pour la recherche. Lorsque le résultat de la recherche est prêt, le slot ou le signal member dans receiver est appelé avec un argument QHostInfo. L'objet QHostInfo peut alors être inspecté pour obtenir les résultats de la recherche.

La consultation est effectuée par un seul appel de fonction, par exemple :

QHostInfo::lookupHost("www.kde.org", this, &MyWidget::lookedUp);

L'implémentation du slot imprime des informations de base sur les adresses renvoyées par la recherche, ou signale une erreur en cas d'échec :

void MyWidget::lookedUp(const QHostInfo &host) { if (host.error() != QHostInfo::NoError) {        qDebug() << "Lookup failed:" << host.errorString();
       return; } const auto addresses = host.addresses() ; for(const QHostAddress &address: addresses)        qDebug() << "Found address:" << address.toString();
}

Si vous transmettez une adresse IP littérale à name au lieu d'un nom d'hôte, QHostInfo recherchera le nom de domaine correspondant à l'IP (c'est-à-dire que QHostInfo effectuera une recherche inversée ). En cas de succès, le résultat QHostInfo contiendra à la fois le nom de domaine résolu et les adresses IP pour le nom d'hôte. Exemple :

QHostInfo::lookupHost("4.2.2.1", this, &MyWidget::lookedUp);

Voir aussi abortHostLookup(), addresses(), error(), et fromName().

[static] template <typename Functor> int QHostInfo::lookupHost(const QString &name, Functor &&functor)

Recherche la ou les adresses IP associées au nom d'hôte name, et renvoie un ID pour la recherche. Lorsque le résultat de la recherche est prêt, functor est appelé avec un argument QHostInfo. L'objet QHostInfo peut alors être inspecté pour obtenir les résultats de la recherche.

La commande functor est exécutée dans le thread qui appelle lookupHost ; ce thread doit avoir une boucle d'événements Qt en cours d'exécution.

Voir aussi abortHostLookup(), addresses(), error(), et fromName().

[static] template <typename Functor> int QHostInfo::lookupHost(const QString &name, const QObject *context, Functor functor)

Recherche la ou les adresses IP associées au nom d'hôte name, et renvoie un ID pour la recherche. Lorsque le résultat de la recherche est prêt, functor est appelé avec un argument QHostInfo. L'objet QHostInfo peut alors être inspecté pour obtenir les résultats de la recherche.

Si context est détruit avant la fin de la consultation, functor ne sera pas appelé. La fonction functor sera exécutée dans le fil d'exécution de context. Le fil d'exécution du contexte doit avoir une boucle d'événement Qt XML en cours d'exécution.

Voici une autre signature pour la fonction :

lookupHost(const QString &name, const QObject *receiver, PointerToMemberFunction function)

Dans ce cas, lorsque le résultat de la recherche est prêt, le slot ou le signal function dans receiver est appelé avec un argument QHostInfo. L'objet QHostInfo peut alors être inspecté pour obtenir les résultats de la recherche.

Voir aussi abortHostLookup(), addresses(), error(), et fromName().

int QHostInfo::lookupId() const

Renvoie l'identifiant de cette recherche.

Voir aussi setLookupId(), abortHostLookup() et hostName().

void QHostInfo::setAddresses(const QList<QHostAddress> &addresses)

Définit la liste des adresses de ce QHostInfo à addresses.

Voir aussi addresses().

void QHostInfo::setError(QHostInfo::HostInfoError error)

Définit le type d'erreur de ce QHostInfo à error.

Voir aussi error() et errorString().

void QHostInfo::setErrorString(const QString &str)

Définit la description lisible par l'homme de l'erreur qui s'est produite à l'adresse str si la consultation a échoué.

Voir également errorString() et setError().

void QHostInfo::setHostName(const QString &hostName)

Définit le nom d'hôte de ce QHostInfo à hostName.

Voir aussi hostName().

void QHostInfo::setLookupId(int id)

Fixe l'ID de cette recherche à id.

Voir aussi lookupId() et lookupHost().

[noexcept] void QHostInfo::swap(QHostInfo &other)

Remplace ce host-info par other. Cette opération est très rapide et n'échoue jamais.

[noexcept] QHostInfo &QHostInfo::operator=(QHostInfo &&other)

Move-assigne other à cette instance QHostInfo.

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

Affecte les données de l'objet other à l'objet host info et renvoie une référence à cet objet.