contains()
contains()
函数用于检查子字符串是否存在于给定字符串或事件的字段值中。它接受两个参数
-
第一个参数是文字字符串或表示要搜索的字段或值的 JSON 指针。
-
第二个参数是要在第一个参数中搜索的子字符串。如果第二个参数中指定的子字符串在第一个参数表示的字符串或字段值中找到,则函数返回
true
。否则返回false
。
例如,如果您想检查字符串 "abcd"
是否包含在名为 message
的字段值中,您可以使用 contains()
函数,如下所示
contains('/message', 'abcd')
如果字段 message
包含子字符串 abcd
,此调用返回 true
,否则返回 false
。
或者,您可以使用文字字符串作为第一个参数
contains('This is a test message', 'test')
在这种情况下,函数返回 true
,因为子字符串 test
存在于字符串 This is a test message
中。
contains()
函数执行区分大小写的搜索。