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 地址。它等同于在处于QNetworkInterface::IsUp 状态的allInterfaces() 返回的所有对象上调用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 上该网络接口的人可读名称，如 "Local Area Connection（局域网连接）"。如果无法确定，该函数的返回值与name() 相同。可读名称是用户可以在 Windows 控制面板中修改的名称，因此在程序执行过程中可能会发生变化。

在 Unix 系统中，由于 Unix 系统不存储人可读名称的配置，因此该函数目前的返回值与name() 相同。

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 字节，如果没有某种形式的报头压缩）。还要注意的是，通往目的地的全路径 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 对象的内容复制到此对象中。