ipv4_is_match()

  • 發行項

比對兩個 IPv4 字串。 系統在計算引數前置詞和選擇性 prefix 引數的合併 IP 前置詞遮罩時，會剖析並比較兩個 IPv4 字串。

語法

ipv4_is_match(ip1,ip2[ ,前綴])

深入瞭解 語法慣例。

參數

名稱 類型 必要 Description
ip1、 ip2 string ✔️ 表示 IPv4 位址的表達式。 您可以使用 IP 首碼標記法來遮罩 IPv4 字串。
prefix int 從 0 到 32 的整數，表示要考慮的最大有效位數目。

IP 首碼標記法

IP 前置詞表示法 (也稱為 CIDR 表示法) 是表示 IP 位址及其相關聯網路掩碼的簡潔方式。 格式為 <base IP>/<prefix length>，其中前置長度是 netmask 中前置 1 位的數目。 前置長度會決定屬於網路的IP位址範圍。

針對 IPv4，前置長度是介於 0 到 32 之間的數位。 因此，表示法 192.168.2.0/24 代表 IP 位址 192.168.2.0，且 netmask 為 255.255.255.0。 此網路掩碼有 24 個前置 1 位，或前置長度為 24。

對於 IPv6，前置長度是介於 0 到 128 之間的數位。 因此，表示法 fe80：：85d：e82c：9446：7994/120 代表 IP 位址 fe80：：85d：e82c：9446：7994，且 netmask 為 ffff：ffff：ff00。 此 netmask 有 120 個前置 1 位，或前置長度為 120。

傳回

  • true：如果第一個 IPv4 字串引數的長整數表示法，等於第二個 IPv4 字串引數。
  • false：則不在範圍內。
  • null：若兩個 IPv4 字串的其中一個無法成功轉換時。

注意

針對不是範圍的 IPv4 位址進行比對時，建議您使用 等號運算子 () == ，以提升效能。

範例

IPv4 比較相等 - IPv4 字串內指定的 IP 首碼標記法

執行查詢

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_is_match(ip1_string, ip2_string)

輸出

ip1_string ip2_string result
192.168.1.0 192.168.1.0 true
192.168.1.1/24 192.168.1.255 true
192.168.1.1 192.168.1.255/24 true
192.168.1.1/30 192.168.1.255/24 true

IPv4 比較相等 - IPv4 字串內指定的 IP 首碼標記法和 ipv4_is_match() 函式的其他引數

執行查詢

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_is_match(ip1_string, ip2_string, prefix)

輸出

ip1_string ip2_string prefix result
192.168.1.1 192.168.1.0 31 true
192.168.1.1/24 192.168.1.255 31 true
192.168.1.1 192.168.1.255 24 true

相關內容