math.Log
返回给定数字的自然对数。
这一页解决什么问题
自然对数(以 e 为底)在模板里偶尔会用到:按数量级分档(例如星级、音量刻度)、把指数增长换算成线性刻度、计算复利期数。
go-html-template
{{ math.Log 42 }} → 3.737什么时候用,什么时候别用
该用:
- 需要自然对数(以 e 为底)做数量级/刻度换算;
- 与
math.Pow互为逆运算时。
别用:
- 想求平方根 → 用
math.Sqrt; - 想求幂 → 用
math.Pow; - 想格式化小数位 → 用
fmt.Printf;上游示例里的3.737是排版上的约简,函数本身返回完整精度。
完整示例:自然对数与它的边界
layouts/_partials/log-demo.htmlgo-html-template
<p>log(42) = {{ math.Log 42 }}</p>
<p>log(0) = {{ math.Log 0 }}</p>Hugo 0.167.0 实测渲染为:
html
<p>log(42) = 3.7376696182833684</p>
<p>log(0) = -Inf</p>你应当看到什么:log(42) 给出完整精度的 3.7376696182833684;log(0) 不报错,返回 -Inf(负无穷),会直接显示在页面上。数学上 ln(0) 无定义,因此对可能为 0 的输入务必先判断。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点,Windows。
| 输入 | 结果 | 是否报错 |
|---|---|---|
42 |
3.7376696182833684(上游写作 3.737) |
否 |
1 |
0 |
否 |
0 |
-Inf |
否 |
负数(如 -1) |
NaN(实测) |
否 |
非数字字符串 "x" |
上游未说明;同类函数的报错见 math.Sqrt |
是 |
| 返回类型 | float64 |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | 页面显示 -Inf |
输入是 0(或极小值) | 先判断 if gt $x 0 |
| 没报错但结果不对 | 结果位数与文档示例不一致 | 上游示例是约简写法,实际是完整精度 | 用 printf "%.3f" 控制显示位数 |
| 没报错但结果不对 | 想要以 10 为底却用了 log |
该函数只提供自然对数 | 用 div (math.Log $x) (math.Log 10) 换算(上游未给出专门函数) |
更多排查入口见故障排查。