我第一次把一个大整数拆成多个 uint32 分片相加时,真正容易写错的不是加法,而是“这一段产生的进位到底交给谁”。math/bits.Add32 正好把这个边界拆成两个返回值:sum 保留当前 32 位结果,carryOut 告诉下一段是否需要加 1。
官方地址:https://pkg.go.dev/math/bits#Add32
结论先落到代码上:低位先传入 carry=0,拿到的进位再传给高位;carry 只能是 0 或 1,最终的 carryOut 不是有符号溢出标记,而是超出当前无符号位宽的额外进位。
先把 Add32 的输入和输出对上
Add32 的签名是 func Add32(x, y, carry uint32) (sum, carryOut uint32)。它计算的是 x + y + carry,其中第三个参数是输入进位,返回的第二个值是输出进位。官方文档明确规定输入进位必须为 0 或 1,传入其它值时行为未定义;输出进位保证为 0 或 1。
我会把它看成一个“单段加法单元”:uint32 输入进入 bits.Add32,结果位从 sum 出来,额外的一位从 carryOut 出来。这样看,比把两个返回值都叫“结果”更不容易接错。
把低位进位接到高位
多字长整数可以用小端分片表示:下标 0 是最低 32 位,后面的元素越来越高。计算时必须从低位开始,因为只有低位算完,才能知道高位的 carryIn。
package main
import (
"fmt"
"math/bits"
)
// addWordsLE 按低位到高位相加,words 使用小端分片。
// 返回值中的最后一个 carry 表示结果是否超出传入的分片宽度。
func addWordsLE(a, b []uint32) ([]uint32, uint32) {
if len(a) != len(b) {
return nil, 0 // 示例只处理等长分片,调用方应先统一宽度。
}
sum := make([]uint32, len(a))
var carry uint32 // 第一段没有外部进位,所以从 0 开始。
for i := 0; i < len(a); i++ {
var next uint32
// next 必须原样传给更高一段,不能把它当普通加数累加。
sum[i], next = bits.Add32(a[i], b[i], carry)
carry = next
}
return sum, carry
}
func main() {
// 数组按低位在前表示两个 64 位无符号数。
a := []uint32{0xffffffff, 1}
b := []uint32{1, 2}
sum, carry := addWordsLE(a, b)
fmt.Printf("sum=%v finalCarry=%d\n", sum, carry)
}
这里最关键的只有一条连接:当前段的 next 变成下一段的 carry。第一段使用 0,不是因为 Add32 会替你初始化,而是因为这次加法没有更低位可以传入进位。
看懂 sum 与 carryOut 的边界
当 x+y+carry 超过 32 位时,sum 只保留低 32 位,超出的部分通过 carryOut=1 表达。例如 0xffffffff + 1 的当前段结果是 sum=0、carryOut=1。这不是数据丢失,而是把结果拆成“当前字宽内的位”和“传给更高字的进位”。
如果分片数组只有两个 uint32,循环结束后仍为 1 的最终进位,就说明完整结果需要第三个 32 位分片才能无损表示。若业务只需要固定 64 位结果,可以把它当作溢出信号;若业务要支持更宽整数,就应该追加这个分片。
最容易混淆的三个边界
| 边界 | 正确理解 | 常见误写 |
|---|---|---|
| carry 输入 | 只能是 0 或 1 | 把上一段的 sum 或任意整数直接传入 |
| sum 输出 | 当前 32 位内的结果 | 把 sum 当成完整的无限精度结果 |
| carryOut 输出 | 额外进位,保证为 0 或 1 | 把它当成有符号整数溢出判断 |
另外,Add32 面向的是无符号位模式。若你在做有符号整数运算,不能只看 carryOut 就下结论;有符号溢出要结合操作数和结果的符号位判断。需要 64 位分片时可以使用同样语义的 bits.Add64,但不要在 32 位代码里因为“类型更大”就随意替换。
写完后我会保留的检查清单
- 分片是否统一为
uint32,并明确低位在前还是高位在前。 - 第一段的
carryIn是否为0,后续段是否接收上一段的carryOut。 - 是否保留最终进位,避免固定宽度结果悄悄截断。
- 代码讨论的是无符号进位,还是另有一套有符号溢出规则。
把 Add32 记成“当前段给出 sum,下一段接收 carryOut”就够了。它适合固定宽度的无符号分片加法;真正决定结果是否完整的,是你有没有继续保存最后那一位进位。
相关问题
- carry 传入 2 会怎样?行为未定义,调用方应先保证它只能为 0 或 1。
- 最终 carryOut 一定要保留吗?固定宽度业务至少要用它判断溢出;可扩展整数则要把它追加为更高分片。
- Add32 能判断有符号溢出吗?不能只靠 carryOut 判断,有符号溢出需要按符号位规则单独判断。