IP解析函数
更新时间：2025-11-28
IP解析函数
简介
本文介绍IP解析函数的语法规则，包括参数解释、函数示例等。
ip_version 函数
函数定义
判断IP地址为IPv4还是IPv6。若是IPv4类型IP地址，则返回IPv4，若是IPv6类型IP地址，则返回IPv6。
语法描述
Text
1ip_version(ip, default="")参数说明
| 参数名称 | 参数描述 | 参数类型 | 是否必须 | 参数默认值 | 参数取值范围 |
|---|---|---|---|---|---|
| ip | 输入IP地址 | Any | 是 | - | - |
| default | 无法判断IP地址版本时，返回该值，默认为空字符串 | String | 否 | "" | - |
示例
- 示例1
原始日志：
Text
1{"ip": "192.168.1.100"} 加工规则：
Text
1e_set("ip_version",ip_version(v("ip")))加工结果：
Text
1{"ip": "192.168.1.100", "ip_version": "IPv4"} - 示例2
原始日志：
Text
1{"ip": "::1"} 加工规则：
Text
1e_set("ip_version",ip_version(v("ip")))加工结果：
Text
1{"ip": "::1", "ip_version": "IPv6"} ip2long 函数
函数定义
使用ip2long函数将字符串格式的IP地址转换成长整型数据。
语法描述
Text
1ip2long(ip, default=0)参数说明
| 参数名称 | 参数描述 | 参数类型 | 是否必须 | 参数默认值 | 参数取值范围 |
|---|---|---|---|---|---|
| ip | 输入IP地址 | Any | 是 | - | - |
| default | 某个不合法的IP地址被转换成的值。支持自定义，默认为0 | Integer | 否 | 0 | - |
示例
- 示例1
原始日志：
Text
1{"ip": "192.168.0.100"} 加工规则：
Text
1e_set("ip2long",ip2long(v("ip")))加工结果：
Text
1{"ip": "192.168.0.100", "ip2long": 3232235620} long2ip 函数
函数定义
使用long2ip函数将长整型数据转换成字符串格式的IP地址。
语法描述
Text
1long2ip(value,default="")参数说明
| 参数名称 | 参数描述 | 参数类型 | 是否必须 | 参数默认值 | 参数取值范围 |
|---|---|---|---|---|---|
| ip | 填入需要被转换的值 | Any | 是 | - | - |
| default | 表示将不合法的长整型数据转成空字符串，支持自定义 | Integer | 否 | "" | - |
示例
- 示例1
原始日志：
Text
1{"value": 3232235620} 加工规则：
Text
1e_set("ip",long2ip(v("value")))加工结果：
Text
1{"ip": "192.168.0.100", "value": 3232235620}