strings

strings.ContainsAny

报告给定字符串是否包含指定字符集合中的任意字符。

签名
strings.ContainsAny STRING SET
返回类型
bool

这一页解决什么问题

有时要判断的不是「有没有这一整段子串」,而是「有没有这一类字符中的任意一个」:路径里有没有分隔符、用户输入里有没有引号、标题里有没有标点。strings.ContainsAny 的第二个参数是一个字符集合(SET),只要 STRING 里出现其中任何一个字符就返回 true。

什么时候用,什么时候别用

该用:

  • 集合里的字符很多、且彼此独立(例如 "/\\"、"'\");
  • 想快速做一次「含不含特殊字符」的初筛。

别用:

用法

go-html-template
{{ strings.ContainsAny "Hugo" "gm" }} → true

该检查区分大小写:

go-html-template
{{ strings.ContainsAny "Hugo" "Gm" }} → false

完整示例(实测)

layouts/_partials/path-check.htmlgo-html-template
{{ $path := "docs/guide.md" }}
含分隔符:{{ strings.ContainsAny $path "/\\" }},含 xyz:{{ strings.ContainsAny $path "xyz" }}

Hugo 0.167.0 实测输出:

含分隔符:true,含 xyz:false

你应当看到什么:/ 在 $path 里出现过,所以第一项为 true;xyz 里的三个字符一个都没出现,所以第二项为 false。

返回值边界(实测)

测量条件:Hugo 0.167.0 extended,单语言站点(locale = 'zh-CN'),Windows。

输入 结果 是否报错
{{ strings.ContainsAny "Hugo" "gm" }} true 否
{{ strings.ContainsAny "Hugo" "Gm" }} false(区分大小写) 否
{{ strings.ContainsAny "汉字" "字" }} true 否
{{ strings.ContainsAny "abc" "" }} false(空集合不匹配任何字符) 否
SET 里有重复或顺序不同 不影响结果(它是集合,不是子串) 否
返回类型 bool,永远不会是 nil 否

常见坑

类别 症状 真因 怎么修
没报错但结果不对 明明含 abc 却返回 false 把 SET 当成了子串:它是字符集合,"abc" 表示 a、b、c 三个字符任一个 判断整段子串改用 strings.Contains
没报错但结果不对 用 " " 判断「有没有空白」漏掉了制表符 空格是一个字符,\t/\n 不在集合里 空白相关的判断改用 strings.ContainsNonSpace

更多排查入口见故障排查。