Класс QNetworkAddressEntry

Класс QNetworkAddressEntry хранит один IP-адрес, поддерживаемый сетевым интерфейсом, вместе с его маской сети и широковещательным адресом. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными.

Типы публичного доступа

Функции публичного доступа

Подробное описание

Каждый сетевой интерфейс может содержать ноль или более IP-адресов, которые, в свою очередь, могут быть связаны с маской сети и/или широковещательным адресом (в зависимости от поддержки операционной системы).

Этот класс представляет собой одну такую группу.

Документация по типам членов

[since 5.11] Перечисление QNetworkAddressEntry::DnsEligibilityStatus

Это перечисление указывает, подходит ли данный адрес хоста для публикации в системе доменных имен (DNS) или других подобных механизмах разрешения имен. В целом, адрес подходит для публикации, если по этому адресу машина будет доступна неопределённое время, хотя он не обязательно должен быть постоянным. Например, адреса, полученные через DHCP, часто подходят, но криптографически сгенерированные временные IPv6-адреса не подходят.

Это перечисление было введено или изменено в Qt 5.11.

См. также dnsEligibility() и setDnsEligibility().

Документация по функциям членов

QNetworkAddressEntry::QNetworkAddressEntry(const QNetworkAddressEntry &other)

Создаёт объект QNetworkAddressEntry, являющийся копией объекта other.

QNetworkAddressEntry::QNetworkAddressEntry()

Создаёт пустой объект QNetworkAddressEntry.

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

Создаёт копию объекта QNetworkAddressEntry other.

QNetworkAddressEntry::~QNetworkAddressEntry()

Уничтожает этот объект QNetworkAddressEntry.

QHostAddress QNetworkAddressEntry::broadcast() const

Возвращает широковещательный адрес, связанный с IPv4-адресом и маской сети. Обычно он может быть получен из этих двух, установив в 1 биты IP-адреса, где маска сети содержит 0. (Другими словами, путём побитового ИЛИ IP-адреса с инверсией маски сети)

Этот член всегда пустой для IPv6-адресов, так как концепция широковещательной рассылки была отменена в этой системе в пользу многоадресной рассылки. В частности, группа хостов, соответствующая всем узлам в локальной сети, может быть достигнута по специальной группе многоадресной рассылки «все узлы» (адрес FF02::1).

См. также setBroadcast().

[since 5.11] void QNetworkAddressEntry::clearAddressLifetime()

Сбрасывает значения предпочтительного и действительного срока жизни для этого адреса. После этого вызова isLifetimeKnown() вернёт false.

Эта функция была введена в Qt 5.11.

См. также preferredLifetime(), validityLifetime(), isLifetimeKnown() и setAddressLifetime().

[since 5.11] QNetworkAddressEntry::DnsEligibilityStatus QNetworkAddressEntry::dnsEligibility() const

Возвращает, подходит ли этот адрес для публикации в системе доменных имён (DNS) или аналогичных механизмах разрешения имён.

В общем случае адрес подходит для публикации, если это адрес, по которому этот компьютер будет доступен в течение неопределенного времени, хотя он не обязательно должен быть постоянным. Например, адреса, полученные через DHCP, часто подходят, но криптографически сгенерированные временные адреса IPv6 не подходят.

В некоторых системах QNetworkInterface должен эвристически определить, какие адреса подходят.

Эта функция была введена в Qt 5.11.

См. также isLifetimeKnown(), isPermanent() и setDnsEligibility().

QHostAddress QNetworkAddressEntry::ip() const

Эта функция возвращает один найденный IPv4 или IPv6 адрес, который был найден в сетевом интерфейсе.

См. также setIp().

[since 5.11] bool QNetworkAddressEntry::isLifetimeKnown() const

Возвращает true , если срок службы адреса известен, false , если нет. Если срок службы не известен, и preferredLifetime(), и validityLifetime() вернут QDeadlineTimer::Forever.

Эта функция была введена в Qt 5.11.

См. также preferredLifetime(), validityLifetime(), setAddressLifetime() и clearAddressLifetime().

[since 5.11] bool QNetworkAddressEntry::isPermanent() const

Возвращает true , если этот адрес является постоянным для этого интерфейса, false , если он временный. Постоянный адрес — это адрес, у которого нет срока действия и который часто является статическим (настраивается вручную).

Если эту информацию нельзя определить, эта функция возвращает true.

Примечание: В зависимости от операционной системы и инструмента конфигурации сети, временный адрес может быть интерпретирован как постоянный, если инструмент не сообщил о подробностях правильно операционной системе.

Эта функция была введена в Qt 5.11.

См. также isLifetimeKnown(), validityLifetime() и isTemporary().

[since 5.11] bool QNetworkAddressEntry::isTemporary() const

Возвращает true , если этот адрес временный для этого интерфейса, false , если он постоянный.

Эта функция была введена в Qt 5.11.

См. также isLifetimeKnown(), validityLifetime() и isPermanent().

QHostAddress QNetworkAddressEntry::netmask() const

Возвращает маску сети, связанную с IP-адресом. Маска сети выражается в виде IP-адреса, например, 255.255.0.0.

Для IPv6-адресов длина префикса преобразуется в адрес, где количество битов, установленных в 1, равно длине префикса. Для длины префикса 64 бита (наиболее частое значение) маска сети будет выражена как QHostAddress, содержащая адрес FFFF:FFFF:FFFF:FFFF::

См. также setNetmask() и prefixLength().

[since 5.11] QDeadlineTimer QNetworkAddressEntry::preferredLifetime() const

Возвращает срок, когда этот адрес становится устаревшим (больше не предпочтительным), если известен. Если срок службы адреса неизвестен (см. isLifetimeKnown()), эта функция всегда возвращает QDeadlineTimer::Forever.

Пока адрес предпочтительный, операционная система может использовать его в качестве адреса источника для новых исходящих пакетов. После того, как он устареет, он останется допустимым для входящих пакетов некоторое время, прежде чем будет удален (см. validityLifetime()).

Эта функция была введена в Qt 5.11.

См. также validityLifetime(), isLifetimeKnown(), setAddressLifetime() и clearAddressLifetime().

int QNetworkAddressEntry::prefixLength() const

Возвращает длину префикса этого IP-адреса. Длина префикса соответствует количеству битов, установленных в 1, в маске сети (см. netmask()). Для IPv4-адресов значение находится в диапазоне от 0 до 32. Для IPv6-адресов оно находится в диапазоне от 0 до 128 и является предпочтительной формой представления адресов.

Функция возвращает -1, если длина префикса не может быть определена (т.е. netmask() возвращает нулевой QHostAddress()).

См. также setPrefixLength() и netmask().

[since 5.11] void QNetworkAddressEntry::setAddressLifetime(QDeadlineTimer preferred, QDeadlineTimer validity)

Устанавливает предпочтительный и действительный сроки для этого адреса соответственно до preferred и validity сроков. После этого вызова isLifetimeKnown() вернёт true, даже если оба параметра равны QDeadlineTimer::Forever.

Эта функция была введена в Qt 5.11.

См. также preferredLifetime(), validityLifetime(), isLifetimeKnown() и clearAddressLifetime().

void QNetworkAddressEntry::setBroadcast(const QHostAddress &newBroadcast)

Устанавливает IP-адрес широковещательной рассылки для этого объекта QNetworkAddressEntry на newBroadcast.

См. также broadcast().

[since 5.11] void QNetworkAddressEntry::setDnsEligibility(QNetworkAddressEntry::DnsEligibilityStatus status)

Устанавливает флаг пригодности DNS для этого адреса на status.

Эта функция была введена в Qt 5.11.

См. также dnsEligibility().

void QNetworkAddressEntry::setIp(const QHostAddress &newIp)

Устанавливает IP-адрес, содержащийся в объекте QNetworkAddressEntry, на newIp.

См. также ip().

void QNetworkAddressEntry::setNetmask(const QHostAddress &newNetmask)

Устанавливает маску сети, содержащуюся в этом объекте QNetworkAddressEntry, на newNetmask. Установка маски сети также устанавливает длину префикса в соответствии с новой маской сети.

См. также netmask() и setPrefixLength().

void QNetworkAddressEntry::setPrefixLength(int length)

Устанавливает длину префикса этого IP-адреса на length. Значение length должно быть допустимым для данного типа IP-адреса: от 0 до 32 для IPv4-адресов, от 0 до 128 для IPv6-адресов. Установка любого недопустимого значения эквивалентна установке -1, что означает «нет длины префикса».

Установка длины префикса также устанавливает маску сети (см. netmask()).

См. также prefixLength() и setNetmask().

[since 5.0] void QNetworkAddressEntry::swap(QNetworkAddressEntry &other)

Меняет местами экземпляр этого сетевого адреса с other. Эта функция очень быстрая и никогда не терпит неудач.

Эта функция была введена в Qt 5.0.

[since 5.11] QDeadlineTimer QNetworkAddressEntry::validityLifetime() const

Возвращает срок, когда этот адрес становится недействительным и будет удален из стека сети, если известен. Если срок службы адреса неизвестен (см. isLifetimeKnown()), эта функция всегда возвращает QDeadlineTimer::Forever.

Пока адрес действителен, операционная система будет принимать его как действительный адрес назначения для этого компьютера. Будет ли он использоваться в качестве адреса источника для новых исходящих пакетов, контролируется, среди прочего, предпочтительным сроком службы (см. preferredLifetime()).

Эта функция была введена в Qt 5.11.

См. также preferredLifetime(), isLifetimeKnown(), setAddressLifetime() и clearAddressLifetime().

bool QNetworkAddressEntry::operator!=(const QNetworkAddressEntry &other) const

Возвращает true если запись о сетевом адресе отличается от other.

bool QNetworkAddressEntry::operator==(const QNetworkAddressEntry &other) const

Возвращает true если запись о сетевом адресе такая же, как other.