ipv4_is_match()

  • Artykuł

Dopasuje dwa ciągi IPv4. Dwa ciągi IPv4 są analizowane i porównywane podczas uwzględniania połączonej maski prefiksów IP obliczonej na podstawie prefiksów argumentów i argumentu opcjonalnego prefix .

Składnia

ipv4_is_match(ip1,ip2[ ,Prefiks])

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
ip1, ip2 string ✔️ Wyrażenie reprezentujące adres IPv4. Ciągi IPv4 można maskować przy użyciu notacji prefiksu IP.
Prefiks int Liczba całkowita z zakresu od 0 do 32 reprezentująca liczbę najbardziej znaczących bitów, które są brane pod uwagę.

Notacja prefiksu IP

Notacja prefiksu IP (znana również jako notacja CIDR) to zwięzły sposób reprezentowania adresu IP i skojarzonej maski sieciowej. Format to <base IP>/<prefix length>, gdzie długość prefiksu jest liczbą wiodących 1 bitów maski sieci. Długość prefiksu określa zakres adresów IP należących do sieci.

W przypadku protokołu IPv4 długość prefiksu jest liczbą z zakresu od 0 do 32. Dlatego notacja 192.168.2.0/24 reprezentuje adres IP 192.168.2.0 maską netto 255.255.255.255.0. Ta maska sieci ma 24 wiodące 1 bity lub długość prefiksu 24.

W przypadku protokołu IPv6 długość prefiksu jest liczbą z zakresu od 0 do 128. Tak więc notacja fe80::85d:e82c:9446:7994/120 reprezentuje adres IP fe80::85d:e82c:9446:7994 z maską netmask ffff:ffff:ffff:ffff:ff00. Ta maska sieci ma 120 wiodących 1 bitów lub długość prefiksu 120.

Zwraca

  • true: Jeśli długa reprezentacja pierwszego argumentu ciągu IPv4 jest równa drugiemu argumentowi ciągu IPv4.
  • false:Inaczej.
  • null: Jeśli konwersja jednego z dwóch ciągów IPv4 nie powiodła się.

Uwaga

W przypadku dopasowywania do adresu IPv4, który nie jest zakresem, zalecamy użycie operatora równości (==), aby uzyskać lepszą wydajność.

Przykłady

Równość porównania IPv4 — notacja prefiksu IP określona wewnątrz ciągów IPv4

Uruchamianie zapytania

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)

Dane wyjściowe

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

Równość porównania IPv4 — notacja prefiksu IP określona wewnątrz ciągów IPv4 i dodatkowy argument ipv4_is_match() funkcji

Uruchamianie zapytania

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)

Dane wyjściowe

ip1_string ip2_string Prefiks 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

Zawartość pokrewna