ipv4_is_match()
Corresponde a duas cadeias IPv4. As duas cadeias IPv4 são analisadas e comparadas ao contabilizar a máscara combinada de prefixo IP calculada a partir de prefixos de argumento e o argumento opcional prefix
.
Syntax
ipv4_is_match(
ip1,
ip2[ ,
prefixo])
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Tipo | Necessário | Descrição |
---|---|---|---|
ip1, ip2 | string |
✔️ | Uma expressão que representa um endereço IPv4. As cadeias IPv4 podem ser mascaradas com notação de prefixo IP. |
prefixo | int |
Um número inteiro de 0 a 32 que representa o número de bits mais significativos que são tidos em conta. |
Notação de prefixo IP
A notação de prefixo IP (também conhecida como notação CIDR) é uma forma concisa de representar um endereço IP e a máscara de rede associada. O formato é <base IP>/<prefix length>
, em que o comprimento do prefixo é o número de 1 bits à esquerda na máscara de rede. O comprimento do prefixo determina o intervalo de endereços IP que pertencem à rede.
Para IPv4, o comprimento do prefixo é um número entre 0 e 32. Assim, a notação 192.168.2.0/24 representa o endereço IP 192.168.2.0 com uma máscara de rede de 255.255.255.0. Esta máscara de rede tem 24 bits à esquerda ou um comprimento de prefixo de 24.
Para IPv6, o comprimento do prefixo é um número entre 0 e 128. Assim, a notação fe80::85d:e82c:9446:7994/120 representa o endereço IP fe80::85d:e82c:9446:7994 com um netmask de ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00. Esta máscara de rede tem 120 bits à esquerda ou um comprimento de prefixo de 120.
Devoluções
true
: se a representação longa do primeiro argumento de cadeia IPv4 for igual ao segundo argumento de cadeia IPv4.false
: caso contrário.null
: se a conversão para uma das duas cadeias IPv4 não tiver sido bem-sucedida.
Nota
Ao fazer a correspondência com um endereço IPv4 que não seja um intervalo, recomendamos que utilize o operador de igual (==
), para um melhor desempenho.
Exemplos
Igualdade de comparação IPv4 – notação de prefixo IP especificada nas cadeias 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_is_match(ip1_string, ip2_string)
Saída
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 |
Igualdade de comparação IPv4 – notação de prefixo IP especificada nas cadeias IPv4 e um argumento adicional da ipv4_is_match()
função
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)
Saída
ip1_string | ip2_string | prefixo | 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 |
Conteúdo relacionado
- Descrição geral das funções IPv4/IPv6
- Descrição geral das funções de correspondência de texto IPv4
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários