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

返回主机上检测到的所有网络接口的列表。如果操作失败，则返回一个包含零个元素的列表。

QNetworkInterface::InterfaceFlags QNetworkInterface::flags() const

返回与该网络接口相关的标志。

QString QNetworkInterface::hardwareAddress() const

返回该接口的低级硬件地址。对于以太网接口，该值将是以字符串形式表示的 MAC 地址，各部分以冒号分隔。

其他类型的接口可能具有其他类型的硬件地址。实现不应依赖于该函数返回有效的 MAC 地址。

另请参阅 type()。

QString QNetworkInterface::humanReadableName() const

在 Windows 系统上，返回此网络接口的易于理解的名称（例如“本地连接”），前提是能够确定该名称。如果无法确定，则该函数的返回结果与name() 相同。 易于理解的名称是用户可以在 Windows 控制面板中修改的名称，因此它可能会在程序执行过程中发生变化。

在 Unix 系统上，该函数目前始终返回与name() 相同的值，因为 Unix 系统不存储可读名称的配置信息。

int QNetworkInterface::index() const

返回接口系统索引（如果已知）。这是一个由操作系统分配的整数，用于标识该接口，通常不会发生变化。它与 IPv6 地址中的“作用域 ID”字段相对应。

如果未知该索引，则该函数返回 0。

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

返回一个表示内部 ID 为index 的接口的QNetworkInterface 对象。网络接口有一个称为“接口索引”的唯一标识符，用于将其与系统上的其他接口区分开来。通常，该值是按顺序分配的，因此被移除后又重新添加的接口每次都会获得不同的值。

该索引也出现在 IPv6 地址的范围标识符（scope 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

返回该接口的最大传输单元（MTU），如果已知；否则返回 0。

最大传输单元（MTU）是指在此接口上发送时，在不引发链路层分片的情况下所能传输的最大数据包大小。应用程序可利用此值计算出能够完整装入未分片的 UDP 数据报中的有效载荷大小。 在计算可传输的有效载荷大小时，请务必减去通过该接口通信时所使用的报头大小，例如 TCP（20 字节）或 UDP（12 字节）、IPv4（20 字节）或 IPv6（40 字节，除非采用某种报头压缩方式）。 另请注意，通往目的地的完整路径上的 MTU（即路径 MTU）可能小于该接口的 MTU。

另请参阅 QUdpSocket 。

QString QNetworkInterface::name() const

返回此网络接口的名称。在 Unix 系统中，这是一个包含接口类型以及可选序列号的字符串，例如“eth0”、“lo”或“pcn0”。在 Windows 系统中，这是一个内部标识符，用户无法更改。

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

将此网络接口实例与other 互换。此操作速度极快，且绝不会失败。

QNetworkInterface::InterfaceType QNetworkInterface::type() const

返回此接口的类型（如果能够确定）。如果无法确定，则该函数返回QNetworkInterface::Unknown 。

另请参阅 hardwareAddress()。

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

将other 中包含的QNetworkInterface 对象的内容复制到该对象中。