TO_IPV4_OR_DEFAULT

to_ipv4_or_default

描述

输入 IPv4 地址的字符串形式，并返回 IPv4 类型的值。对于无效输入或 NULL 输入，返回默认值 0.0.0.0。

语法

TO_IPV4_OR_DEFAULT(<ipv4_str>)

参数

• <ipv4_str>：字符串类型的 IPv4 地址

返回值

返回类型：IPv4

返回值含义：

• 返回 IPv4 类型值，其二进制形式等同于 ipv4_string_to_num 的返回值
• 输入 NULL 或非法 IPv4 地址时返回 0.0.0.0

使用说明

• 等价于 to_ipv4_or_default → IPv4 类型，适合建表为 IPv4 列的场景
• 对于无效输入不会抛出异常，而是返回默认值 0.0.0.0

举例

将 IPv4 文本 255.255.255.255 转为 IPv4 类型。

SELECT to_ipv4_or_default('255.255.255.255') as v4;
+-----------------+
| v4              |
+-----------------+
| 255.255.255.255 |
+-----------------+

输入 NULL 返回默认值 0.0.0.0。

SELECT to_ipv4_or_default(NULL) as v4;
+---------+
| v4      |
+---------+
| 0.0.0.0 |
+---------+

非法 IPv4 文本返回默认值 0.0.0.0。

SELECT to_ipv4_or_default('256.1.1.1') as v4;
+---------+
| v4      |
+---------+
| 0.0.0.0 |
+---------+

Keywords

TO_IPV4_OR_DEFAULT