Функции и операторы для сетевых адресов

Типы cidr и inet, предназначенные для сетевых IP-адресов, поддерживают обычные операторы сравнения, приведенные в таблице Операторы сравнения, а также специальные операторы и функции, приведенные в Таблице 38 и Таблице 39.

Любое значение типа cidr можно привести к типу inet неявно, поэтому операторы и функции, показанные ниже для типа inet, также работают со значениями типа cidr. (Там, где для inet cidr показаны разные функции, причина этого в том, что в данном случае их поведение с этими двумя типами различается.) Кроме того, разрешено приведение значения типа inet к типу cidr. При этому все биты справа от сетевой маски молча обнуляются, чтобы создать допустимое значение типа cidr.

Таблица 38. Операторы для IP-адресов

Оператор
	Описание Пример(ы)
inet << inet → boolean
	Первая подсеть строго содержится во второй? Этот и следующие четыре оператора проверяют вхождение одной подсети в другую. Они рассматривают только сетевые части двух заданных адресов (игнорируя все биты справа от сетевой маски) и определяют, идентична ли одна сеть другой или является ее подсетью. `inet '192.168.1.5' << inet '192.168.1/24' → t` `inet '192.168.0.5' << inet '192.168.1/24' → f` `inet '192.168.1/24' << inet '192.168.1/24' → f`
inet <<= inet → boolean
	Первая подсеть содержится во второй или равна ей? `inet '192.168.1/24' <<= inet '192.168.1/24' → t`
inet >> inet → boolean
	Первая подсеть строго содержит вторую? `inet '192.168.1/24' >> inet '192.168.1.5' → t`
inet >>= inet → boolean
	Первая подсеть содержит вторую или равна ей? `inet '192.168.1/24' >>= inet '192.168.1/24' → t`
inet && inet → boolean
	Одна из двух подсетей содержит другую или равна ей? `inet '192.168.1/24' && inet '192.168.1.80/28' → t` `inet '192.168.1/24' && inet '192.168.2.0/28' → f`
~ inet → inet
	Вычисляет результат побитового НЕ. `~ inet '192.168.1.6' → 63.87.254.249`
inet & inet → inet
	Вычисляет результат побитового И. `inet '192.168.1.6' & inet '0.0.0.255' → 0.0.0.6`
inet \| inet → inet
	Вычисляет результат побитового ИЛИ. `inet '192.168.1.6' \| inet '0.0.0.255' → 192.168.1.255`
inet + bigint → inet
	Добавляет смещение к адресу. `inet '192.168.1.6' + 25 → 192.168.1.31`
bigint + inet → inet
	Добавляет смещение к адресу. `200 + inet '::ffff:fff0:1' → ::ffff:255.240.0.201`
inet - bigint → inet
	Вычитает смещение из адреса. `inet '192.168.1.43' - 36 → 192.168.1.7`
inet - inet → bigint
	Вычисляет разность двух адресов. `inet '192.168.1.43' - inet '192.168.1.19' → 24 inet '::1' - inet '::ffff:1' → -4294901760`

Таблица 39. Функции для IP-адресов

Функция
	Описание Пример(ы)
abbrev ( inet ) → text
	Создает сокращенный формат отображения адреса в виде текста. (Результат получается тот же, что и у функции вывода inet; «сокращенным» он является только в сравнении с результатом явного приведения к типу text, которое по историческим причинам никогда не будет убирать часть с сетевой маской.) `abbrev(inet '10.1.0.0/32') → 10.1.0.0`
abbrev ( cidr ) → text
	Создает сокращенный формат отображения адреса в виде текста. (Это сокращение заключается в отбрасывании полностью нулевых октетов справа от сетевой маски; другие примеры см. в таблице Примеры вводимых значений типа cidr.) `abbrev(cidr '10.1.0.0/16') → 10.1/16`
broadcast ( inet ) → inet
	Вычисляет широковещательный адрес для сети в заданном адресе. `broadcast(inet '192.168.1.5/24') → 192.168.1.255/24`
family ( inet ) → integer
	Возвращает семейство адреса: 4 для адресов IPv4, 6 для адресов IPv6. `family(inet '::1') → 6`
host ( inet ) → text
	Возвращает IP-адрес в виде текста, игнорируя сетевую маску. `host(inet '192.168.1.0/24') → 192.168.1.0`
hostmask ( inet ) → inet
	Вычисляет маску хоста для сети в заданном адресе. `hostmask(inet '192.168.23.20/30') → 0.0.0.3`
inet_merge ( inet, inet ) → cidr
	Вычисляет наименьшую сеть, содержащую обе заданные сети. `inet_merge(inet '192.168.1.5/24', inet '192.168.2.5/24') → 192.168.0.0/22`
inet_same_family ( inet, inet ) → boolean
	Проверяет, принадлежат ли адреса одному семейству IP. `inet_same_family(inet '192.168.1.5/24', inet '::1') → f`
masklen ( inet ) → integer
	Возвращает длину сетевой маски в битах. `masklen(inet '192.168.1.5/24') → 24`
netmask ( inet ) → inet
	Вычисляет сетевую маску для сети в заданном адресе. `netmask(inet '192.168.1.5/24') → 255.255.255.0`
network ( inet ) → cidr
	Возвращает сетевую часть адреса, обнуляя все биты справа от сетевой маски. (Это равнозначно приведению значения к типу cidr.) `network(inet '192.168.1.5/24') → 192.168.1.0/24`
set_masklen ( inet, integer ) → inet
	Задает длину сетевой маски для значения типа inet. Адресная часть при этом не меняется. `set_masklen(inet '192.168.1.5/24', 16) → 192.168.1.5/16`
set_masklen ( cidr, integer ) → cidr
	Задает длину сетевой маски для значения cidr. Биты адреса справа от новой сетевой маски при этом устанавливаются в ноль. `set_masklen(cidr '192.168.1.0/24', 16) → 192.168.0.0/16`
text ( inet ) → text
	Возвращает несокращенный IP-адрес и длину сетевой маски в виде текста. (Такой же результат получается при явном приведении к типу text.) `text(inet '192.168.1.5') → 192.168.1.5/32`

Совет
Функции abbrev, host и text предназначены в основном для отображения IP-адресов в альтернативных форматах.

Типы для MAC-адресов, macaddr и macaddr8, поддерживают обычные операторы сравнения, приведенные в таблице Операторы сравнения, а также специальные функции, приведенные в Таблице 40. Кроме того, они поддерживают побитовые логические операторы ~, & и | (НЕ, И и ИЛИ), показанные выше для IP-адресов.

Таблица 40. Функции для MAC-адресов

Функция
	Описание Пример(ы)
trunc ( macaddr ) → macaddr
	Устанавливает в ноль 3 последних байта адреса. Оставшийся префикс можно сопоставить с конкретным производителем (используя информацию, отсутствующую в QHB). `trunc(macaddr '12:34:56:78:90:ab') → 12:34:56:00:00:00`
trunc ( macaddr8 ) → macaddr8
	Устанавливает в ноль 5 последних байта адреса. Оставшийся префикс можно сопоставить с конкретным производителем (используя информацию, отсутствующую в QHB). `trunc(macaddr8 '12:34:56:78:90:ab:cd:ef') → 12:34:56:00:00:00:00:00`
macaddr8_set7bit ( macaddr8 ) → macaddr8
	Устанавливает единицу в 7-м бите адреса, создавая так называемый модифицированный идентификатор EUI-64 для включения в адрес IPv6. `macaddr8_set7bit(macaddr8 '00:34:56:ab:cd:ef') → 02:34:56:ff:fe:ab:cd:ef`