math.ModBool
报告两个整数的模是否等于 0。
这一页解决什么问题
「第 n 行是不是偶数行」「这个数字能不能被 3 整除」——这类判断只需要真假,不需要余数本身。modBool 把「取模 + 判断为 0」合成一步,读起来也比 eq (mod $i 2) 0 更直白。
go-html-template
{{ modBool 15 3 }} → true什么时候用,什么时候别用
该用:
- 交替样式(斑马纹)、按固定周期分组;
- 判断整除关系。
别用:
- 需要余数本身做下标 → 用
math.Mod; - 想判断奇偶但更看重可读性 → 两种写法等价,
modBool $i 2已经足够清楚; - 操作数是浮点数 → 该函数只接受整数(与
math.Mod相同)。
完整示例:给列表加斑马纹
layouts/_partials/zebra.htmlgo-html-template
{{ range $i, $p := slice "a" "b" "c" }}<li class="{{ if modBool $i 2 }}even{{ else }}odd{{ end }}">{{ $p }}</li>
{{ end }}Hugo 0.167.0 实测渲染为:
html
<li class="even">a</li>
<li class="odd">b</li>
<li class="even">c</li>你应当看到什么:range 的索引 $i 从 0 开始,所以第一项是 even。如果你希望「第一行是 odd」,把两个类名对调,或者判断 modBool (add $i 1) 2。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点,Windows。
| 输入 | 结果 | 是否报错 |
|---|---|---|
15 3 |
true |
否 |
15 4 |
false |
否 |
$i = 0、除数 2 |
true(0 能被 2 整除) |
否 |
| 非整数 | —— | 是:与 math.Mod 相同的「需要整数」类错误 |
| 除数为 0 | —— | 是:除零错误(同 math.Mod) |
| 返回类型 | bool |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | 第一条的样式和预期相反 | range 索引从 0 开始 |
对调类名,或用 modBool (add $i 1) 2 |
| 报错看不懂 | 报错提到需要整数 | 传入了浮点数或字符串 | 用 cast.ToInt 转换 |
| 没报错但结果不对 | 周期分组错位 | 除数是集合长度时,写法写反了 | 确认是 modBool $i (len $groups) |
更多排查入口见故障排查。