ipv4_compare()

  • Статья

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

Синтаксис

ipv4_compare(Expr1,Expr2[ ,PrefixMask])

Параметры

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

Нотация 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: если длинное представление первого аргумента строки IPv4 равно второму строкового аргументу IPv4.
  • 1: если длинное представление первого аргумента строки IPv4 больше второго аргумента строки IPv4.
  • -1: если длинное представление первого аргумента строки IPv4 меньше второго аргумента строки IPv4.
  • null: если преобразование для одной из двух строк IPv4 не было успешным.

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

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

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

datatable(ip1_string:string, ip2_string:string)
[
 '192.168.1.0',    '192.168.1.0',       // Equal IPs
 '192.168.1.1/24', '192.168.1.255',     // 24 bit IP-prefix is used for comparison
 '192.168.1.1',    '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 = ipv4_compare(ip1_string, ip2_string)

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

ip1_string ip2_string набор по
192.168.1.0 192.168.1.0 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

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

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

datatable(ip1_string:string, ip2_string:string, prefix:long)
[
 '192.168.1.1',    '192.168.1.0',   31, // 31 bit IP-prefix is used for comparison
 '192.168.1.1/24', '192.168.1.255', 31, // 24 bit IP-prefix is used for comparison
 '192.168.1.1',    '192.168.1.255', 24, // 24 bit IP-prefix is used for comparison
]
| extend result = ipv4_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

См. также