登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go math/bits.Add32 怎样处理 32 位整数的进位

来源:17golang原创

时间:2026-11-17 17:45:23 202浏览 收藏

我第一次把一个大整数拆成多个 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 出来。这样看,比把两个返回值都叫“结果”更不容易接错。

低位 uint32、高位 uint32、bits.Add32、sum、carryOut 和下一段 carryIn 的静态关系说明图
图1:Add32 的进位链结构说明图,查看低位输出如何成为高位输入。

把低位进位接到高位

多字长整数可以用小端分片表示:下标 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 输入、0xffffffff、sum、carryOut 以及最终溢出的静态边界说明图
图2:sum 与 carryOut 的边界说明图,区分 32 位结果和额外进位。

如果分片数组只有两个 uint32,循环结束后仍为 1 的最终进位,就说明完整结果需要第三个 32 位分片才能无损表示。若业务只需要固定 64 位结果,可以把它当作溢出信号;若业务要支持更宽整数,就应该追加这个分片。

最容易混淆的三个边界

边界正确理解常见误写
carry 输入只能是 0 或 1把上一段的 sum 或任意整数直接传入
sum 输出当前 32 位内的结果把 sum 当成完整的无限精度结果
carryOut 输出额外进位,保证为 0 或 1把它当成有符号整数溢出判断

另外,Add32 面向的是无符号位模式。若你在做有符号整数运算,不能只看 carryOut 就下结论;有符号溢出要结合操作数和结果的符号位判断。需要 64 位分片时可以使用同样语义的 bits.Add64,但不要在 32 位代码里因为“类型更大”就随意替换。

写完后我会保留的检查清单

  1. 分片是否统一为 uint32,并明确低位在前还是高位在前。
  2. 第一段的 carryIn 是否为 0,后续段是否接收上一段的 carryOut。
  3. 是否保留最终进位,避免固定宽度结果悄悄截断。
  4. 代码讨论的是无符号进位,还是另有一套有符号溢出规则。

把 Add32 记成“当前段给出 sum,下一段接收 carryOut”就够了。它适合固定宽度的无符号分片加法;真正决定结果是否完整的,是你有没有继续保存最后那一位进位。

相关问题

  • carry 传入 2 会怎样?行为未定义,调用方应先保证它只能为 0 或 1。
  • 最终 carryOut 一定要保留吗?固定宽度业务至少要用它判断溢出;可扩展整数则要把它追加为更高分片。
  • Add32 能判断有符号溢出吗?不能只靠 carryOut 判断,有符号溢出需要按符号位规则单独判断。
声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>