你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
返回一个值,该值指示指定的 IPv4 地址之一是否显示在文本中。
文本中的 IP 地址入口必须以非字母数字字符正确分隔。 例如,正确分隔的 IP 地址是:
- “这些请求来自:192.168.1.1、10.1.1.115 和 10.1.1.201”
- “05:04:54 127.0.0.1 GET /favicon.ico 404”
性能提示
注释
使用超过 128 个搜索词时,将禁用文本索引查找优化,这可能会导致查询性能降低。
语法
has_any_ipv4(
源,
ip_address [,
ip_address_2,
...] )
详细了解语法约定。
参数
客户 | 类型 | 必需 | 说明 |
---|---|---|---|
源 | string |
✔️ | 要搜索的值。 |
ip_address | 字符串或动态 | ✔️ | 要搜索的 IP 地址或 IP 地址数组。 |
返回
如果其中一个指定的 IP 地址是有效的 IPv4 地址,并且已在 source 中找到,则返回 true
。 否则,该函数返回 false
。
示例
以下示例演示如何结合使用 has_any_ipv4
多个标量值,其中每个 IP 地址都作为单独的字符串参数提供。 文本中的 IP 地址由非字母数字字符正确分隔。
print result=has_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '127.0.0.2')
结果 |
---|
是 |
以下示例演示如何将 IP 地址动态数组一 has_any_ipv4
起使用。 文本中的 IP 地址由非字母数字字符正确分隔。
print result=has_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', dynamic(['127.0.0.1', '127.0.0.2']))
结果 |
---|
是 |
以下示例演示如何将 IPv4 地址与无效的 IPv4 地址一 has_any_ipv4
起使用。 文本中的 IP 地址由非字母数字字符正确分隔。
print result=has_any_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', dynamic(["127.0.0.256", "192.168.1.1"]))
结果 |
---|
假 |
以下示例演示了如何与 has_any_ipv4
未正确分隔的 IP 地址一起使用。 文本中的 IP 地址未正确用非字母数字字符分隔。
print result=has_any_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '192.168.1.1') // false, improperly delimited IP address
结果 |
---|
假 |