cast.ToInt
返回给定值转换后的十进制整数(base 10)。
这一页解决什么问题
需要整数的场合比想象中多:循环次数、切片下标、collections.First 的 N、weight 排序值、分页参数。这些值常常是字符串写进来的(前置元数据、配置、短代码参数),而 Hugo 的整数参数不接受字符串。
int(即 cast.ToInt)负责把它变成 int。它同时也是最容易被前导零坑到的转换函数,本页把这一点单独讲清楚。
什么时候用,什么时候别用
该用:
- 需要
int才能用的参数与运算:first N、slice下标、seq、整数比较; - 把「字符串写法的数量」变成真正能参与算术的整数;
- 从浮点数取整(向下截断,
int 11.9→11)。
别用:
- 需要小数 → 用
cast.ToFloat;int会直接丢掉小数部分,而且不四舍五入; - 想按「四舍五入」取整 → 先用
math.Round再int; - 字符串带前导零(
"0011")却又想按十进制理解 → 先strings.TrimLeft "0"再int,否则得到八进制的 9; - 想解析日期/时间戳 → 用
time系列函数。
上游给出的各种进制输入结果
输入为十进制(base 10)时:
go-html-template
{{ int 11 }} → 11 (int)
{{ int "11" }} → 11 (int)
{{ int 11.1 }} → 11 (int)
{{ int 11.9 }} → 11 (int)输入为二进制(base 2)时:
go-html-template
{{ int 0b11 }} → 3 (int)
{{ int "0b11" }} → 3 (int)输入为八进制(base 8)时(两种记法都可用):
go-html-template
{{ int 011 }} → 9 (int)
{{ int "011" }} → 9 (int)
{{ int 0o11 }} → 9 (int)
{{ int "0o11" }} → 9 (int)输入为十六进制(base 16)时:
go-html-template
{{ int 0x11 }} → 17 (int)
{{ int "0x11" }} → 17 (int){{ strings.TrimLeft "0" "0011" | int }} → 11
完整示例:把字符串数量转成整数
layouts/_partials/count.htmlgo-html-template
{{ $s := "0011" }}
<p>{{ int (strings.TrimLeft "0" $s) }}</p>
<p>{{ int 11.9 }} / {{ int "0x11" }}</p>
<p>{{ int "" }} / {{ int nil }} / {{ int true }}</p>Hugo 渲染为(变量赋值行本身会留下空行,这里省略):
html
<p>11</p>
<p>11 / 17</p>
<p>0 / 0 / 1</p>你应当看到什么:"0011" 必须先 TrimLeft "0" 才能得到十进制的 11(不处理会得到 9);int 11.9 是 11,小数被截断而不是四舍五入;空字符串与 nil 都静默变成 0。最后一行的三个结果分别来自空字符串、nil 和布尔 true——它们全都不报错,所以「数据缺失」在这个函数里是隐形的。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点(locale = 'zh-CN'),Windows。
| 输入 | 结果 | 是否报错 |
|---|---|---|
整数、可解析的十进制字符串(11、"11") |
对应 int |
否 |
浮点数字面量 / 浮点字符串(11.9、"11.9") |
11(截断,不四舍五入) |
否 |
"011" |
9(按八进制解析,上游已说明) |
否 |
带进制前缀的字符串("0b11"、"0o11"、"0x11") |
按对应进制解析,实测分别为 3、9、17 |
否 |
"" |
0 |
否 |
nil |
0 |
否 |
布尔 true / false |
1 / 0 |
否 |
"abc"(无法解析的字符串) |
—— | 是:error calling int: unable to cast "abc" of type string to int: strconv.ParseInt: parsing "abc": invalid syntax |
| 返回类型 | int |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | "0011" 得到 9 而不是 11 |
字符串被按八进制解析 | 先 strings.TrimLeft "0",或改用 cast.ToFloat |
| 没报错但结果不对 | 循环次数、分页参数在数据缺失时变成 0,页面空了一块 | int "" 与 int nil 都返回 0 |
转换前判空,或显式写默认值 |
| 没报错但结果不对 | 11.9 变成 11,以为会四舍五入 |
int 只截断小数部分 |
需要四舍五入就先用 math.Round |
| 报错看不懂 | unable to cast "abc" of type string to int |
字符串不是合法整数 | 检查数据源;需要小数就用 cast.ToFloat |
更多排查入口见故障排查。