compare.Ne
报告第一个参数是否不等于后续参数中的任意一个。
这一页解决什么问题
「不相等」在模板里和「相等」一样常见:排除某个 section、跳过当前项、判断参数不是默认值。ne 就是 eq 的反面,写 ne 比写 not (eq …) 更直接。
ne 与 compare.Ne 是同一个函数:ne 是别名。
读懂本页的诀窍:ne 的多参数语义与 eq 完全相反——eq 是「等于任意一个」,ne 是「不等于所有后续参数」。参数一多,这一点最容易记反。
什么时候用,什么时候别用
该用:
- 排除式判断:
{{ if ne .Section "drafts" }}; - 判断参数「不是某个值」,比
not (eq …)少一层括号; - 与
eq成对使用,让两个分支的语义对称。
别用:
- 想筛出集合里所有满足条件的元素 → 用
where; - 想判断「不在切片里」→ 用
collections.In取反(not (in …))更清楚,ne比较的是两个值,不是「值 vs 集合」; - 数字与字符串混用 → 实测
ne 1 "1"是true:它不会把字符串当数字。需要数值比较先cast.ToInt/cast.ToFloat; - 只想做布尔取反且比较对象多于一个 → 直接用
not包住eq,可读性更好。
用法
compare.Ne 函数报告第一个参数是否不等于后续参数中的任意一个。数字按值比较,与类型无关。你也可以用该函数比较字符串、布尔值、日期以及其他可比较的数据类型。
示例
go-html-template
{{ compare.Ne 1 1 }} → false
{{ compare.Ne 1 2 }} → true
{{ compare.Ne 1 1 1 }} → false
{{ compare.Ne 1 1 2 }} → false
{{ compare.Ne 1 2 1 }} → false
{{ compare.Ne 1 2 2 }} → true比较不同类型的数字:
go-html-template
{{ compare.Ne 1 1.0 }} → false比较其他数据类型:
go-html-template
{{ compare.Ne "ab" "a" }} → true
{{ compare.Ne time.Now (time.AsTime "1964-12-30") }} → true
{{ compare.Ne true false }} → true完整示例:排除当前布局并跳过默认值
layouts/_partials/layout-check.htmlgo-html-template
{{ $layout := "post" }}
<p>{{ ne $layout "page" }}</p>
<p>{{ ne 1 1.0 }}</p>
<p>{{ ne 1 "1" }}</p>
<p>{{ ne (slice 1 2) (slice 2 1) }}</p>Hugo 渲染为(变量赋值行本身会留下空行,这里省略):
html
<p>true</p>
<p>false</p>
<p>true</p>
<p>true</p>你应当看到什么:第二行 ne 1 1.0 是 false——int 与 float 按值相等,所以「不相等」不成立;第三行 ne 1 "1" 是 true——数字与字符串不等(与 eq 的 false 正好互为反面)。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点(locale = 'zh-CN'),Windows。
| 比较 | 结果 | 是否报错 |
|---|---|---|
ne 1 1 / ne 1 2 |
false / true |
否 |
ne 1 1.0(int 与 float) |
false |
否 |
ne 1 "1"(数字与字符串) |
true |
否 |
ne nil nil |
false(与 eq nil nil 的 true 相反) |
否 |
ne (slice 1 2) (slice 2 1)(内容不同) |
true |
否 |
ne (slice 1 2) (slice 1 2)(内容相同) |
false |
否 |
ne 1(1 个参数) |
—— | 是:error calling ne: missing arguments for comparison |
| 返回类型 | bool |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | ne $x 1 2 期望「不等于 1 也不等于 2」,结果反了 |
多参数 ne 是「全部不等」;eq 才是「任一相等」 |
记住对称性:eq 任一相等为真,ne 全部不等才为真 |
| 没报错但结果不对 | 参数里写着 1,ne .Params.n 1 却是 true |
类型不同(数字 vs 字符串) | 先 cast.ToInt 统一类型 |
| 没报错但结果不对 | 用 ne 判断「元素不在切片里」不生效 |
ne 比较两个值,不处理「值 vs 集合」 |
用 collections.In 加 not |
| 报错看不懂 | missing arguments for comparison |
只传了一个参数 | ne 至少需要两个参数 |
更多排查入口见故障排查。