Contribute in GitHub:
Edit online
parse_ipv6_mask()
Converts IPv6/IPv4 string and netmask to a canonical IPv6 string representation.
parse_ipv6_mask("127.0.0.1", 24) == '0000:0000:0000:0000:0000:ffff:7f00:0000'
parse_ipv6_mask(":fe80::85d:e82c:9446:7994", 120) == 'fe80:0000:0000:0000:085d:e82c:9446:7900'
Syntax
parse_ipv6_mask(Expr, PrefixMask)
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
| Expr | String | ✓ | String expression representing IPv6/IPv4 network address that will be converted to canonical IPv6 representation. String may include net-mask using IP-prefix notation. |
| PrefixMask | string | An integer from 0 to 128 representing the number of most-significant bits that are taken into account. If argument isn't specified, all bit-masks are used (32). |
IP-prefix notation
IP addresses can be defined with IP-prefix notation using a slash (/) character. The IP address to the LEFT of the slash (/) is the base IP address. The number (1 to 127) to the RIGHT of the slash (/)
is the number of contiguous 1 bit in the netmask.
Returns
If conversion is successful, the result will be a string representing a canonical IPv6 network address. If conversion isn't successful, the result will be null.
Example
datatable(ip_string:string, netmask:long)
[
// IPv4 addresses
'192.168.255.255', 120, // 120-bit netmask is used
'192.168.255.255/24', 124, // 120-bit netmask is used, as IPv4 address doesn't use upper 8 bits
'255.255.255.255', 128, // 128-bit netmask is used
// IPv6 addresses
'fe80::85d:e82c:9446:7994', 128, // 128-bit netmask is used
'fe80::85d:e82c:9446:7994/120', 124, // 120-bit netmask is used
// IPv6 with IPv4 notation
'::192.168.255.255', 128, // 128-bit netmask is used
'::192.168.255.255/24', 128, // 120-bit netmask is used, as IPv4 address doesn't use upper 8 bits
]
| extend ip6_canonical = parse_ipv6_mask(ip_string, netmask)
Results
| ip_string | netmask | ip6_canonical |
|---|---|---|
| 192.168.255.255 | 120 | 0000:0000:0000:0000:0000:ffff:c0a8:ff00 |
| 192.168.255.255/24 | 124 | 0000:0000:0000:0000:0000:ffff:c0a8:ff00 |
| 255.255.255.255 | 128 | 0000:0000:0000:0000:0000:ffff:ffff:ffff |
| fe80::85d:e82c:9446:7994 | 128 | fe80:0000:0000:0000:085d:e82c:9446:7994 |
| fe80::85d:e82c:9446:7994/120 | 124 | fe80:0000:0000:0000:085d:e82c:9446:7900 |
| ::192.168.255.255 | 128 | 0000:0000:0000:0000:0000:ffff:c0a8:ffff |
| ::192.168.255.255/24 | 128 | 0000:0000:0000:0000:0000:ffff:c0a8:ff00 |