QNetworkInterface Class

メンバー機能文書

QNetworkInterface::QNetworkInterface()

空のネットワーク・インターフェース・オブジェクトを構築します。

QNetworkInterface::QNetworkInterface(const QNetworkInterface &other)

other に含まれる QNetworkInterface オブジェクトのコピーを作成します。

[noexcept] QNetworkInterface::~QNetworkInterface()

QNetworkInterface オブジェクトに関連付けられたリソースを解放します。

QList<QNetworkAddressEntry> QNetworkInterface::addressEntries() const

このインターフェースが持つIPアドレスのリストを、関連するネットマスクとブロードキャスト・アドレスとともに返す。

ネットマスクやブロードキャストアドレスなどの情報が不要な場合は、allAddresses （）関数を呼び出して、アクティブなインタフェースのIPアドレスだけを取得することができる。

[static] QList<QHostAddress> QNetworkInterface::allAddresses()

この便宜関数は、ホスト・マシンで見つかったすべてのIPアドレスを返す。この関数は、allInterfaces()で返されたオブジェクトのうち、QNetworkInterface::IsUp の状態にあるすべてのオブジェクトに対してaddressEntries()を呼び出して、QNetworkAddressEntry オブジェクトのリストを取得し、その各オブジェクトに対してQNetworkAddressEntry::ip()を呼び出すのと同じである。

[static] QList<QNetworkInterface> QNetworkInterface::allInterfaces()

ホスト・マシンで見つかったすべてのネットワーク・インタフェースのリストを返す。失敗した場合は、要素数0のリストを返す。

QNetworkInterface::InterfaceFlags QNetworkInterface::flags() const

このネットワーク・インターフェースに関連付けられたフラグを返します。

QString QNetworkInterface::hardwareAddress() const

このインタフェースの低レベルハードウェアアドレスを返す。イーサネット・インターフェースの場合、これはコロンで区切られた文字列表現のMACアドレスになります。

他のインターフェース・タイプでは、他のタイプのハードウェア・アドレスを持つかもしれない。実装は、この関数が有効なMACアドレスを返すことに依存してはならない。

type()も参照のこと 。

QString QNetworkInterface::humanReadableName() const

Windows 上でこのネットワーク・インタフェースの人間が読める名前（「Local Area Connection」のような）を決定できた場合、その名前を返す。判別できなかった場合、この関数はname() と同じものを返す。人間が読み取り可能な名前は、Windowsのコントロール・パネルでユーザーが変更できる名前であるため、プログラムの実行中に変更される可能性がある。

Unixでは、この関数は現在のところ常にname （）と同じものを返す。これは、Unixシステムには人間が読める名前の構成が保存されていないためである。

int QNetworkInterface::index() const

インターフェース・システム・インデックスを返します。これはオペレーティングシステムがこのインターフェイスを識別するために割り当てる整数で、通常は変更されない。IPv6アドレスのスコープIDフィールドと一致する。

インデックスがわからない場合、この関数は0を返す。

[static] QNetworkInterface QNetworkInterface::interfaceFromIndex(int index)

内部 ID がindex であるインターフェースのQNetworkInterface オブジェクトを返す。ネットワーク・インターフェースは、システム上の他のインターフェースと区別するために、「インターフェース・インデックス」と呼ばれる一意の識別子を持つ。多くの場合、この値は漸進的に割り当てられ、削除され、再び追加されるインターフェースは、毎回異なる値を得る。

このインデックスは、IPv6アドレスのスコープIDフィールドにもある。

[static] QNetworkInterface QNetworkInterface::interfaceFromName(const QString &name)

name というインターフェースのQNetworkInterface オブジェクトを返す。そのようなインタフェースが存在しない場合、この関数は無効なQNetworkInterface オブジェクトを返す。

文字列name は、実際のインターフェース名（"eth0 "や "en1 "など）か、文字列形式のインターフェー ス・インデックス（"1 "や "2 "など）である。

name() およびisValid()も参照のこと 。

[static] int QNetworkInterface::interfaceIndexFromName(const QString &name)

名前がname であるインターフェースのインデックスを返すか、その名前のインターフェースがない場合は0を返す。この関数は以下のコードと同じ結果を返すはずですが、おそらく実行速度は速くなります。

    QNetworkInterface::interfaceFromName(name).index()

interfaceFromName()、interfaceNameFromIndex()、QNetworkDatagram::interfaceIndex()も参照の こと。

[static] QString QNetworkInterface::interfaceNameFromIndex(int index)

インデックスがindex であるインターフェースの名前、またはそのインデックスを持つインターフェースがない場合は空文字列を返します。この関数は以下のコードと同じ結果を返すはずですが、おそらく実行速度は速くなります。

    QNetworkInterface::interfaceFromIndex(index).name()

interfaceFromIndex()、interfaceIndexFromName()、QNetworkDatagram::interfaceIndex()も参照 。

bool QNetworkInterface::isValid() const

このQNetworkInterface オブジェクトがネットワーク・インターフェースに関する有効な情報を含んでいる場合、true を返す。

int QNetworkInterface::maximumTransmissionUnit() const

既知の場合はこのインターフェイスの最大伝送単位を、そうでない場合は 0 を返す。

最大送信単位は、リンクレベルのフラグメントを発生させずにこのインターフェイス上で送信できる最大のパケットである。アプリケーションはこの値を使って、フラグメントされないUDPデータグラムに収まるペイロードサイズを計算することができる。送信可能なペイロードのサイズを計算するときは、インターフェイス上の通信で使用されるヘッダーのサイズ（例えば、TCP（20バイト）またはUDP（12バイト）、IPv4（20）またはIPv6（40、何らかのヘッダー圧縮がない場合）を差し引くことを忘れないでください。また、宛先までのフルパス（Path MTU）に沿ったMTUは、インターフェースのMTUよりも小さい場合があることに注意してください。

QUdpSocketも参照の こと。

QString QNetworkInterface::name() const

このネットワーク・インタフェースの名前を返します。Unixシステムでは、これはインタフェースの種類を含む文字列であり、オプションで "eth0"、"lo"、"pcn0 "などのシーケンス番号も含まれる。Windowsでは、ユーザーが変更できない内部IDである。

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

このネットワーク・インターフェース・インスタンスをother と交換する。この操作は非常に高速で、失敗することはない。

QNetworkInterface::InterfaceType QNetworkInterface::type() const

このインタフェースの型を決定できた場合、それを返す。判別できなかった場合、この関数はQNetworkInterface::Unknown を返す。

hardwareAddress()も参照 。

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

other に含まれるQNetworkInterface オブジェクトの内容をこのオブジェクトにコピーする。