ipv6_compare()

  • Статья

Сравнивает две строки сетевых адресов IPv6 или IPv4. Две строки IPv6 анализируются и сравниваются с учетом объединенной маски префикса IP-адреса, вычисляемой на основе префиксов аргументов, и необязательного prefix аргумента.

Примечание

Функция может принимать и сравнивать аргументы, представляющие сетевые адреса IPv6 и IPv4. Однако если вызывающий объект знает, что аргументы имеют формат IPv4, используйте функцию ipv4_is_compare(). Эта функция приведет к повышению производительности среды выполнения.

Синтаксис

ipv6_compare(ip1,ip2[ ,Префикс])

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя Тип Обязательно Описание
ip1, ip2 string ✔️ Выражение, представляющее адрес IPv6 или IPv4. Строки IPv6 и IPv4 можно маскировать с помощью нотации IP-префикса.
prefix int Целое число от 0 до 128, представляющее количество наиболее значимых битов, которые учитываются.

Нотация ip-префикса

Нотация IP-префикса (также известная как нотация CIDR) — это краткий способ представления IP-адреса и связанной с ним маски сети. Формат — <base IP>/<prefix length>, где длина префикса — это число ведущих 1 бита в маске сети. Длина префикса определяет диапазон IP-адресов, принадлежащих сети.

Для IPv4 длина префикса — это число от 0 до 32. Таким образом, нотация 192.168.2.0/24 представляет IP-адрес 192.168.2.0 с маской сети 255.255.255.0. Эта маска сети имеет 24 начального 1 бита или длину префикса 24.

Для IPv6 длина префикса — это число от 0 до 128. Таким образом, нотация fe80::85d:e82c:9446:7994/120 представляет IP-адрес fe80::85d:e82c:9446:7994 с маской сети ffff:ffff:ffff:ffff:ffff:ffff. Эта маска сети содержит 120 ведущих 1 бит или длину префикса 120.

Возвращаемое значение

  • 0: если длинное представление первого строкового аргумента IPv6 равно второму строкового аргументу IPv6.
  • 1: если длинное представление первого строкового аргумента IPv6 больше второго строкового аргумента IPv6.
  • -1: если длинное представление первого строкового аргумента IPv6 меньше второго строкового аргумента IPv6.
  • null: если преобразование для одной из двух строк IPv6 не выполнено.

Примеры: случаи сравнения IPv6/IPv4

Сравнение IP-адресов с помощью нотации IP-префикса, указанной в строках IPv6/IPv4

Выполнить запрос

datatable(ip1_string:string, ip2_string:string)
[
 // IPv4 are compared as IPv6 addresses
 '192.168.1.1',    '192.168.1.1',       // Equal IPs
 '192.168.1.1/24', '192.168.1.255',     // 24 bit IP4-prefix is used for comparison
 '192.168.1.1',    '192.168.1.255/24',  // 24 bit IP4-prefix is used for comparison
 '192.168.1.1/30', '192.168.1.255/24',  // 24 bit IP4-prefix is used for comparison
  // IPv6 cases
 'fe80::85d:e82c:9446:7994', 'fe80::85d:e82c:9446:7994',         // Equal IPs
 'fe80::85d:e82c:9446:7994/120', 'fe80::85d:e82c:9446:7998',     // 120 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994', 'fe80::85d:e82c:9446:7998/120',     // 120 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994/120', 'fe80::85d:e82c:9446:7998/120', // 120 bit IP6-prefix is used for comparison
 // Mixed case of IPv4 and IPv6
 '192.168.1.1',      '::ffff:c0a8:0101', // Equal IPs
 '192.168.1.1/24',   '::ffff:c0a8:01ff', // 24 bit IP-prefix is used for comparison
 '::ffff:c0a8:0101', '192.168.1.255/24', // 24 bit IP-prefix is used for comparison
 '::192.168.1.1/30', '192.168.1.255/24', // 24 bit IP-prefix is used for comparison
]
| extend result = ipv6_compare(ip1_string, ip2_string)

Выходные данные

ip1_string ip2_string набор по
192.168.1.1 192.168.1.1 0
192.168.1.1/24 192.168.1.255 0
192.168.1.1 192.168.1.255/24 0
192.168.1.1/30 192.168.1.255/24 0
fe80::85d:e82c:9446:7994 fe80::85d:e82c:9446:7994 0
fe80::85d:e82c:9446:7994/120 fe80::85d:e82c:9446:7998 0
fe80::85d:e82c:9446:7994 fe80::85d:e82c:9446:7998/120 0
fe80::85d:e82c:9446:7994/120 fe80::85d:e82c:9446:7998/120 0
192.168.1.1 ::ffff:c0a8:0101 0
192.168.1.1/24 ::ffff:c0a8:01ff 0
::ffff:c0a8:0101 192.168.1.255/24 0
::192.168.1.1/30 192.168.1.255/24 0

Сравнение IP-адресов с помощью нотации префикса IP-адресов, указанной в строках IPv6/IPv4, и в качестве дополнительного аргумента ipv6_compare() функции

Выполнить запрос

datatable(ip1_string:string, ip2_string:string, prefix:long)
[
 // IPv4 are compared as IPv6 addresses 
 '192.168.1.1',    '192.168.1.0',   31, // 31 bit IP4-prefix is used for comparison
 '192.168.1.1/24', '192.168.1.255', 31, // 24 bit IP4-prefix is used for comparison
 '192.168.1.1',    '192.168.1.255', 24, // 24 bit IP4-prefix is used for comparison
   // IPv6 cases
 'fe80::85d:e82c:9446:7994', 'fe80::85d:e82c:9446:7995',     127, // 127 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994/127', 'fe80::85d:e82c:9446:7998', 120, // 120 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994/120', 'fe80::85d:e82c:9446:7998', 127, // 120 bit IP6-prefix is used for comparison
 // Mixed case of IPv4 and IPv6
 '192.168.1.1/24',   '::ffff:c0a8:01ff', 127, // 127 bit IP6-prefix is used for comparison
 '::ffff:c0a8:0101', '192.168.1.255',    120, // 120 bit IP6-prefix is used for comparison
 '::192.168.1.1/30', '192.168.1.255/24', 127, // 120 bit IP6-prefix is used for comparison
]
| extend result = ipv6_compare(ip1_string, ip2_string, prefix)

Выходные данные

ip1_string ip2_string prefix набор по
192.168.1.1 192.168.1.0 31 0
192.168.1.1/24 192.168.1.255 31 0
192.168.1.1 192.168.1.255 24 0
fe80::85d:e82c:9446:7994 fe80::85d:e82c:9446:7995 127 0
fe80::85d:e82c:9446:7994/127 fe80::85d:e82c:9446:7998 120 0
fe80::85d:e82c:9446:7994/120 fe80::85d:e82c:9446:7998 127 0
192.168.1.1/24 ::ffff:c0a8:01ff 127 0
::ffff:c0a8:0101 192.168.1.255 120 0
::192.168.1.1/30 192.168.1.255/24 127 0

См. также