QHostInfo Class

メンバ関数ドキュメント

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

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

lookupId()も参照 。

QHostInfo::QHostInfo(const QHostInfo &other)

other のコピーを作成する。

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

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

[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);

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

voidMyWidget::lookedUp(constQHostInfo&host) {if(host.error()!=QHostInfo::NoError) { もし        qDebug() << "Lookup failed:" << host.errorString();
       return; }const autoaddresses=host.addresses();for(constQHostAddressアドレス)        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

この検索の 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 オブジェクトのデータを代入し、その参照を返します。