ipv6_is_match()
比對兩個 IPv6 或 IPv4 網路位址字串。 系統在計算從引數首碼和選用的 prefix
引數計算的合併 IP 首碼遮罩時,會剖析並比較兩個 IPv6/IPv4 字串。
注意
函式可以接受和比較代表 IPv6 和 IPv4 網路位址的引數。 如果呼叫端知道引數是 IPv4 格式,則使用 ipv4_is_match() 函式。 此函式會產生更好的執行階段效能。
語法
ipv6_is_match(
ip1,
ip2[ ,
前綴])
深入瞭解 語法慣例。
參數
名稱 | 類型 | 必要 | Description |
---|---|---|---|
ip1、 ip2 | string |
✔️ | 表示 IPv6 或 IPv4 位址的表達式。 可以使用 IP 首碼標記法來為 IPv6 和 IPv4 字串加上遮罩。 |
prefix | int |
從 0 到 128 的整數,表示要考慮的最大有效位數目。 |
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
:如果第一個 IPv6/IPv4 字串引數的 Long 表示法,等於第二個 IPv6/IPv4 字串引數。false
:不在範圍內。null
:若兩個 IPv6/IPv4 字串的其中一個無法成功轉換。
範例
IPv6/IPv4 比較等式案例 - IPv6/IPv4 字串內指定的 IP 首碼標記法
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_is_match(ip1_string, ip2_string)
輸出
ip1_string | ip2_string | result |
---|---|---|
192.168.1.1 | 192.168.1.1 | 1 |
192.168.1.1/24 | 192.168.1.255 | 1 |
192.168.1.1 | 192.168.1.255/24 | 1 |
192.168.1.1/30 | 192.168.1.255/24 | 1 |
fe80::85d:e82c:9446:7994 | fe80::85d:e82c:9446:7994 | 1 |
fe80::85d:e82c:9446:7994/120 | fe80::85d:e82c:9446:7998 | 1 |
fe80::85d:e82c:9446:7994 | fe80::85d:e82c:9446:7998/120 | 1 |
fe80::85d:e82c:9446:7994/120 | fe80::85d:e82c:9446:7998/120 | 1 |
192.168.1.1 | ::ffff:c0a8:0101 | 1 |
192.168.1.1/24 | ::ffff:c0a8:01ff | 1 |
::ffff:c0a8:0101 | 192.168.1.255/24 | 1 |
::192.168.1.1/30 | 192.168.1.255/24 | 1 |
IPv6/IPv4 比較等式案例 - IPv6/IPv4 字串內指定的 IP 首碼標記法並作為 ipv6_is_match()
函式的其他引數
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_is_match(ip1_string, ip2_string, prefix)
輸出
ip1_string | ip2_string | prefix | result |
---|---|---|---|
192.168.1.1 | 192.168.1.0 | 31 | 1 |
192.168.1.1/24 | 192.168.1.255 | 31 | 1 |
192.168.1.1 | 192.168.1.255 | 24 | 1 |
fe80::85d:e82c:9446:7994 | fe80::85d:e82c:9446:7995 | 127 | 1 |
fe80::85d:e82c:9446:7994/127 | fe80::85d:e82c:9446:7998 | 120 | 1 |
fe80::85d:e82c:9446:7994/120 | fe80::85d:e82c:9446:7998 | 127 | 1 |
192.168.1.1/24 | ::ffff:c0a8:01ff | 127 | 1 |
::ffff:c0a8:0101 | 192.168.1.255 | 120 | 1 |
::192.168.1.1/30 | 192.168.1.255/24 | 127 | 1 |
相關內容
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應