QNetworkInterface 类

成员函数文档

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()返回的所有对象上调用addressEntries()，这些对象处于QNetworkInterface::IsUp状态，然后对每个这样的对象调用QNetworkAddressEntry::ip()。

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

返回主机机器上找到的所有网络接口的列表。如果失败，它返回包含零个元素的列表。

QNetworkInterface::InterfaceFlags QNetworkInterface::flags() const

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

QString QNetworkInterface::hardwareAddress() const

返回此接口的低级别硬件地址。对于以太网接口，这将是表示为字符串的MAC地址，由冒号分隔。

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

另请参阅 类型()。

QString QNetworkInterface::humanReadableName() const

返回Windows上此网络接口的易读名称，例如 "本地连接"，如果可以确定名称。如果无法确定，则此函数返回与 name() 相同的值。易读名称是用户可以在Windows控制面板中修改的名称，因此它可能在程序执行期间更改。

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

int QNetworkInterface::index() const

如果已知，返回接口系统索引。这是由操作系统分配的整数，用于标识此接口，通常不会更改。它与IPv6地址中的作用域ID字段匹配。

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

[静态] QNetworkInterface QNetworkInterface::interfaceFromIndex(int index)

返回具有内部ID为 index 的 QNetworkInterface 对象。网络接口有一个唯一的标识符，称为“接口索引”，用于区分系统中其他接口。通常，此值是逐步分配的，移除后再添加的接口每次都会获得不同的值。

此索引还出现在IPv6地址的作用域ID字段中。

[静态] QNetworkInterface QNetworkInterface::interfaceFromName(const QString &name)

返回名为 name 的 QNetworkInterface 对象。如果不存在此类接口，则此函数返回一个无效的 QNetworkInterface 对象。

name 字符串可以是实际的接口名称（例如 "eth0" 或 "en1"）或接口索引的字符串形式（"1"、"2" 等）。

另请参阅 name() 和 isValid()。

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

返回名为 name 的接口的索引或0（如果没有带有该名称的接口）。此函数应产生与以下代码相同的结果，但可能执行速度更快。

    QNetworkInterface::interfaceFromName(name).index()

另请参阅 interfaceFromName()、interfaceNameFromIndex() 和 QNetworkDatagram::interfaceIndex()。

[静态] 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。

最大传输单元是可以在不引起链路层碎片化的情况下发送的最大数据包。应用程序可以使用此值来计算未fragmented的UDP数据包的负载大小。记得在工作在接口上的通信头部大小（例如，TCP（20 字节）或UDP（12）、IPv4（20）或IPv6（40，无需某种形式的头部压缩）时，计算可以传输的负载大小。此外，请注意，到目的地的完整路径（路径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 对象的内容复制到此。