Skip to main content

IPV4_STRING_TO_NUM_OR_DEFAULT

Description​

Takes a string containing an IPv4 address in the format A.B.C.D (dot-separated numbers in decimal form). Returns a BIGINT number representing the corresponding IPv4 address in big endian.

Syntax​

IPV4_STRING_TO_NUM_OR_DEFAULT(<ipv4_string>)

Parameters​

ParameterDescription
<ipv4_string>String type of ipv4, like 'A.B.C.D'

Return Value​

Returns a BIGINT number representing the corresponding IPv4 address in big endian.

  • If the input string is not a valid IPv4 address or NULL, 0 is returned.

Example​

select ipv4_string_to_num_or_default('192.168.0.1');
+----------------------------------------------+ 
| ipv4_string_to_num_or_default('192.168.0.1') |
+----------------------------------------------+
| 3232235521 |
+----------------------------------------------+
select str, ipv4_string_to_num_or_default(str) from ipv4_str; 
+-----------------+------------------------------------+ 
|str | ipv4_string_to_num_or_default(str) |
+-----------------+------------------------------------+
| 0.0.0.0 | 0 |
| 127.0.0.1 | 2130706433 |
| 255.255.255.255 | 4294967295 |
| invalid | 0 |
+-----------------+------------------------------------+