Golang高效处理ISO4217定点十进制货币运算插件库fpmoney的使用

精确性很重要：使用浮点数表示货币几乎是犯罪。 — Robert.C.Martin，《代码整洁之道》第301页

特性

• 与int64一样快速
• 解析和打印时不使用float，不会丢失精度
• 支持ISO 4217标准货币
• 阻止不匹配货币的算术运算
• 仅100行代码
• 包含模糊测试

完整示例

package main

import (
	"encoding/json"
	"fmt"
	"log"
	
	"github.com/nikolaydubina/fpmoney"
)

func main() {
	// 创建SGD货币的固定价格
	var BuySP500Price = fpmoney.FromInt(9000, fpmoney.SGD)

	// JSON输入数据
	input := []byte(`{"sp500": {"amount": 9000.02, "currency": "SGD"}}`)

	// 定义结构体来解析JSON
	type Stonks struct {
		SP500 fpmoney.Amount `json:"sp500"`
	}
	var v Stonks
	
	// 解析JSON
	if err := json.Unmarshal(input, &v); err != nil {
		log.Fatal(err)
	}

	// 初始化购买金额为0 SGD
	amountToBuy := fpmoney.FromInt(0, fpmoney.SGD)
	
	// 如果当前价格高于购买价格，则买入两倍金额
	if v.SP500.GreaterThan(BuySP500Price) {
		amountToBuy = amountToBuy.Add(v.SP500.Mul(2))
	}

	// 输出结果
	fmt.Println(amountToBuy)
	// 输出: 18000.04 SGD
}

极小分数处理

某些货币的面额分数非常小。使用int64存储时：

• BTC的"聪"(satoshi)是1 BTC = 100,000,000 satoshi，仍然足够存储约92,233,720,368 BTC
• ETH的"wei"是1 ETH = 1,000,000,000,000,000,000 wei，只能存储约9 ETH。如果需要处理wei，可能需要考虑使用bigint或多个int64

性能基准测试

$ go test -bench=. -benchmem .
goos: darwin
goarch: arm64
pkg: github.com/nikolaydubina/fpmoney
cpu: Apple M3 Max
BenchmarkCurrency_UnmarshalText-16      711695404                1.610 ns/op           0 B/op          0 allocs/op
BenchmarkCurrency_AppendText-16         446232057                2.698 ns/op           0 B/op          0 allocs/op
BenchmarkCurrency_MarshalText-16        81956246                13.99 ns/op            8 B/op          1 allocs/op
BenchmarkCurrency_String-16             1000000000               1.064 ns/op           0 B/op          0 allocs/op
BenchmarkArithmetic/add-16              924924993                1.305 ns/op           0 B/op          0 allocs/op
BenchmarkJSON/small/encode-16            6004620               198.5 ns/op           160 B/op          3 allocs/op
BenchmarkJSON/small/decode-16            5047149               238.7 ns/op           152 B/op          2 allocs/op
BenchmarkJSON/large/encode-16            4739722               255.7 ns/op           176 B/op          3 allocs/op
BenchmarkJSON/large/decode-16            3737406               315.3 ns/op           152 B/op          2 allocs/op
BenchmarkBinary/small/encode-16         132380481                9.044 ns/op          16 B/op          1 allocs/op
BenchmarkBinary/small/decode-16         100000000               10.80 ns/op           16 B/op          1 allocs/op
BenchmarkBinary/large/encode-16         133549021                8.995 ns/op          16 B/op          1 allocs/op
BenchmarkBinary/large/decode-16         100000000               10.61 ns/op           16 B/op          1 allocs/op
PASS
ok      github.com/nikolaydubina/fpmoney        15.804s

参考和相关工作

• ferdypruis/iso4217 是一个很好的灵感和参考材料
• github.com/shopspring/decimal: 固定精度；更快的打印/解析/算术运算；货币处理
• github.com/Rhymond/go-money: 解析时不使用float或interface{}；货币是枚举
• github.com/ferdypruis/iso4217: 跳过已弃用的货币以适应uint8和更小的结构大小