QHostInfo Class

メンバ関数 ドキュメント

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

ルックアップ IDid を持つ空のホスト情報オブジェクトを構築します。

lookupId()も参照して ください。

QHostInfo::QHostInfo(const QHostInfo &other)

other のコピーを構築します。

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

移動-other から新しい QHostInfo を構築します。

[noexcept] QHostInfo::~QHostInfo()

ホスト情報オブジェクトを破棄します。

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

lookupHost() が返す IDid 、ホスト検索を中止する。

lookupHost() およびlookupId()も参照 。

QList<QHostAddress> QHostInfo::addresses() const

hostName() に関連付けられた IP アドレスのリストを返します。このリストは空でもよい。

例：

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

setAddresses （）、hostName （）、error （）も 参照。

QHostInfo::HostInfoError QHostInfo::error() const

ホスト名の検索に失敗した場合、発生したエラーのタイプを返す。そうでない場合は、NoError を返す。

setError() およびerrorString()も 参照。

QString QHostInfo::errorString() const

ルックアップに失敗した場合、この関数はエラーの内容を可読形式で返す。

setErrorString() およびerror() も参照 。

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

与えられたホストname のIPアドレスを検索する。この関数はルックアップ中にブロックされ、ルックアップの結果が得られるまでプログラムの実行は中断される。検索結果をQHostInfo オブジェクトで返します。

ホスト名の代わりにリテラルIPアドレスをname に渡すと、QHostInfo はそのIPのドメイン名を検索します（つまり、QHostInfo は逆引きを実行します）。成功した場合、返されるQHostInfo には、解決されたドメイン名とホスト名のIPアドレスの両方が含まれる。

lookupHost()も参照 。

QString QHostInfo::hostName() const

IP アドレスが検索されたホストの名前を返します。

setHostName() およびlocalHostName() も参照して ください。

[static] QString QHostInfo::localDomainName()

このマシンの DNS ドメインを返します。

hostName()も参照 。

[static] QString QHostInfo::localHostName()

ホスト名が設定されている場合、このマシンのホスト名を返す。ホスト名がグローバルに一意であることは保証されないことに注意。

この関数は、返されるホスト名が完全修飾ドメイン名（FQDN）であることを保証しない。その場合は、fromName （）を使用して、返された名前をFQDNに解決する。

この関数は、QSysInfo::machineHostName() と同じものを返す。

hostName() およびlocalDomainName()も参照 。

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

ホスト名name に関連付けられた IP アドレスを検索し、検索用の ID を返します。ルックアップの結果が準備できると、receiver のスロットまたはシグナルmember がQHostInfo 引数で呼び出される。その後、QHostInfo オブジェクトを検査して、ルックアップの結果を得ることができる。

ルックアップは、例えば1回の関数呼び出しで実行される：

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

スロットの実装は、ルックアップによって返されたアドレスの基本情報を表示し、失敗した場合はエラーを報告する：

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();
}

ホスト名の代わりにリテラルIPアドレスをname に渡すと、QHostInfo はIPのドメイン名を検索する(つまり、QHostInfo は逆引きを実行する)。成功した場合、結果のQHostInfo には、解決されたドメイン名とホスト名のIPアドレスの両方が含まれる。例

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

abortHostLookup(),addresses(),error(),fromName()も参照してください 。

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

これはオーバーロードされた関数である。

ホスト名name に関連付けられた IP アドレスを検索し、検索用の ID を返す。ルックアップの結果が準備できると、QHostInfo を引数としてfunctor が呼び出される。その後、QHostInfo オブジェクトを検査して、ルックアップの結果を得ることができる。

functor は lookupHost を呼び出したスレッドで実行されます。そのスレッドでは Qt イベントループが実行されている必要があります。

abortHostLookup(),addresses(),error(),fromName()も参照してください 。

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

これはオーバーロードされた関数です。

ホスト名name に関連付けられた IP アドレスを検索し、検索用の ID を返します。ルックアップの結果が準備できると、QHostInfo を引数としてfunctor が呼び出される。その後、QHostInfo オブジェクトを検査して、ルックアップの結果を得ることができる。

ルックアップが完了する前にcontext が破棄されると、functor は呼び出されない。functor はcontext のスレッドで実行されます。 コンテキストのスレッドでは、Qt イベントループが実行されている必要があります。

この関数の別のシグネチャを示します：

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

この場合、ルックアップの結果が準備できると、receiver のスロットまたはシグナルfunction が、QHostInfo の引数で呼び出されます。そして、QHostInfo オブジェクトを検査して、ルックアップの結果を得ることができる。

abortHostLookup()、addresses()、error()、fromName()も参照 。

int QHostInfo::lookupId() const

この lookup の ID を返します。

setLookupId()、abortHostLookup()、hostName()も参照 。

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

このQHostInfo 内のアドレスのリストをaddresses に設定します。

addresses() も参照 。

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

このQHostInfo のエラー・タイプをerror に設定します。

error() およびerrorString()も参照のこと 。

void QHostInfo::setErrorString(const QString &str)

ルックアップに失敗した場合に、発生したエラーについて人間が読める説明をstr に設定します。

errorString() およびsetError() も参照 。

void QHostInfo::setHostName(const QString &hostName)

このQHostInfo のホスト名をhostName に設定します。

hostName() も参照 。

void QHostInfo::setLookupId(int id)

この検索の ID をid に設定します。

lookupId() およびlookupHost() も参照して ください。

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

ホスト情報other をこのホスト情報と交換します。この操作は非常に高速で、失敗することはありません。

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

Move-assignother をこのQHostInfo インスタンスに割り当てます。

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

other オブジェクトのデータをこのホスト情報オブジェクトに割り当て、その参照を返します。