shopspring/decimal
0
Fork 0
mirror of https://github.com/shopspring/decimal.git synced 2026-10-24 08:03:37 +00:00
Code Issues Releases 4 Packages Activity

Compare commits

base: shopspring:v1.3.0
Branches Tags
shopspring:master
shopspring:decomposer-interface
shopspring:v1.6.0
shopspring:v1.5.0
shopspring:v1.4.0
shopspring:v1.3.1
shopspring:v1.3.0
shopspring:v1.0.0
shopspring:v1.0.1
shopspring:v1.1.0
shopspring:v1.2.0
...
compare: shopspring:master
Branches Tags
shopspring:master
shopspring:decomposer-interface
shopspring:v1.6.0
shopspring:v1.5.0
shopspring:v1.4.0
shopspring:v1.3.1
shopspring:v1.3.0
shopspring:v1.0.0
shopspring:v1.0.1
shopspring:v1.1.0
shopspring:v1.2.0

82 commits
v1.3.0 ... master

Author SHA1 Message Date
Mateusz Wos
447b833d1e
 		docs: changelog for v1.6.0 (#477) 2026-10-18 17:33:05 +02:00
Yusuf Efe
4ce352fe15
 		fix: reject overflowing division precision (#472) 
Signed-off-by: Yusuf Efe <120668197+yuefdev@users.noreply.github.com>
Co-authored-by: mwoss <wos.mateusz16@gmail.com>
 2026-10-18 17:29:12 +02:00
Mateusz Wos
540b915359
 		docs: add udecimal to the alternative libraries (#476) 2026-10-18 17:19:27 +02:00
Mateusz Wos
54748831b6
 		docs: show how to control the JSON format of one field (#475) 2026-10-18 17:16:13 +02:00
Mateusz Wos
ddb96d1ae7
 		fix: clearer error when scanning NULL into a Decimal (#474) 2026-10-18 16:56:12 +02:00
Ryoya Sekino
59f775d55c
 		README: Fix URLs for the official Go pages (#264) 
Co-authored-by: mwoss <wos.mateusz16@gmail.com>
 2026-10-18 16:47:19 +02:00
Mateusz Wos
100aebf14a
 		feat: add Root and RootRound (#473) 2026-10-18 16:44:29 +02:00
Mateusz Wos
bed77f5cb6
 		fix: Ln rounds correctly, computed with error bounds like Pow (#471) 
Co-authored-by: vera-rubin <322284620+vera-rubin@users.noreply.github.com>
 2026-10-17 23:45:12 +02:00
adam magued
37aad64c5a
 		feat: add NewFromBigFloat constructor (#457) 
Co-authored-by: mwoss <wos.mateusz16@gmail.com>
 2026-10-17 23:29:19 +02:00
Raiven Kao
78a38f8f6f
 		perf: NewFromFloat uses strconv, drop the vendored strconv copy (#431) 
* perf: delegate NewFromFloat shortest-decimal conversion to strconv

NewFromFloat and NewFromFloat32 need the shortest decimal digit string
that round-trips back to the input float. strconv already computes
exactly that for FormatFloat with precision -1, but the library computes
it itself through decimal-go.go and rounding.go, a copy of the 2009
strconv/decimal.go: assign the mantissa into an 800-byte digit buffer,
shift it one binary bit at a time, then walk the digits against the two
neighbouring floats to find where they diverge.

Ask strconv for the value in 'e' format instead and read the digits back
out. The 'e' layout is [-]d[.ddd]e+dd, at most 24 bytes and trivial to
scan, unlike 'f' which can run past 750 bytes at the exponent extremes.
The result is identical, so no caller-visible behaviour changes.

Benchmarks (Ryzen 9 5900X, -benchtime 2s -count 5, median):

               go1.22           go1.27
  Float    366 -> 168 ns    332 ->  94 ns
  Float32  271 -> 130 ns    241 ->  92 ns

Allocations are unchanged at 2 / 40 B, both from the big.NewInt that
Decimal.value requires. The gap widens on go1.27 because that release
replaced strconv's shortest-float conversion with the uscale algorithm.

Before go1.13, strconv.FormatFloat could return a shortest form that was
not the nearest one (golang/go#29491, the bug behind the two test table
entries added for it), so the old path is kept behind a !go1.13 build
tag. Nothing changes for go1.10 through go1.12; once the module's
minimum Go version passes 1.13, decimal-go.go, rounding.go and
newfromfloat_legacy.go can be deleted outright, removing 575 lines.

Verified equivalent against the previous implementation on go1.13 and
go1.27 over all 4,278,190,078 non-zero finite float32 bit patterns and
578,922,574 float64 values (random bit patterns, every power of two and
its neighbours, and a dense subnormal sweep), with no mismatch.

Tested on go1.10.8, go1.11.13, go1.12.17, go1.13.15, go1.22.12 and
go1.27.0.

* refactor: use strconv on every Go version, drop the vendored strconv copy

Keeping the old implementation behind build tags for Go 1.10-1.12 meant maintaining two
copies of NewFromFloat. Those versions now go through strconv too, which there can pick a
different, still round-tripping shortest form in rare cases (golang/go#29491), so the two
test cases for that only run on Go 1.13 and later.

---------

Co-authored-by: mwoss <wos.mateusz16@gmail.com>
 2026-10-17 23:21:43 +02:00
Mateusz Wos
4fef1ec699
 		fix: ExpHullAbrham returns the requested number of significant figures for large inputs (#470) 2026-10-17 21:32:15 +02:00
Bing Gao
77f8f075c2
 		fix: ExpHullAbrham drops significant figures for results below 1 (#429) 
ExpHullAbrham is documented to return overallPrecision significant
figures, but its final rounding used a separate branch when the result
was < 1 and rounded to overallPrecision decimal places instead. That
discarded the leading-zero positions, so results below 0.1 lost
significant figures and collapsed to 0 once the leading-zero count
reached overallPrecision -- e.g. exp(-50).ExpHullAbrham(10) returned 0
(true value 1.93e-22).

The >=1 branch formula currentPrecision - resNumDigits - res.exp is the
significant-figure-correct rounding position in both cases, so drop the
branch. Positive arguments and results in [0.1,1) are unchanged.

Correct the negative rows of the ExpHullAbrham table (they encoded the
truncated values) and add a significant-figure sweep over the negative
half-line, checked against exp(x) to 40+ digits.

Co-authored-by: mwoss <wos.mateusz16@gmail.com>
 2026-10-17 21:30:33 +02:00
Mateusz Wos
5bc569143a
 		feat: Scan accepts Decimal, big.Int and all integer sizes (#469) 
Co-authored-by: Pavel Skorikov <5002158+it66ru@users.noreply.github.com>
Co-authored-by: Lucca Dukic <109136188+LuccaBitfly@users.noreply.github.com>
Co-authored-by: Anucha Petchagun <corelmax@gmail.com>
Co-authored-by: agammann <161159040+agammann@users.noreply.github.com>
 2026-10-17 21:00:54 +02:00
Mateusz Wos
9e64f2e188
 		docs: fix doc examples that were wrong or didn't compile (#468) 
Co-authored-by: Takamura <plehanov.v@gmail.com>
 2026-10-17 20:47:30 +02:00
Mateusz Wos
175974ac6b
 		test: fix benchmarks that measured setup or the wrong function (#467) 
Co-authored-by: Igor Mikushkin <igor.mikushkin@gmail.com>
 2026-10-17 20:36:28 +02:00
cdpzyafk
1863390911
 		perf: use Sign() instead of Cmp(zeroInt) in IsInteger and Ceil 
Co-authored-by: terry <terry@bituniverse.org>
Co-authored-by: mwoss <wos.mateusz16@gmail.com>
 2026-10-16 23:15:40 +02:00
Mateusz Wos
0146aff76d
 		docs: warn that global settings are not goroutine-safe, list them in the README (#466) 2026-10-16 22:52:22 +02:00
Mateusz Wos
2d97fa9ba3
 		feat: add Sqrt and SqrtRound (#465) 2026-10-16 18:21:15 +02:00
Mateusz Wos
c5d65cf1e9
 		feat: add Normalize method (#464) 2026-10-16 14:43:08 +02:00
Mateusz Wos
ec4943b1a3
 		feat: implement fmt.Formatter (#463) 2026-10-15 20:05:04 +02:00
Mateusz Wos
e799c20820
 		feat: BSON Decimal128 support for the MongoDB Go driver v2 (#460) 2026-10-14 19:27:42 +02:00
Mateusz Wos
511ed65a12
 		chore: turn off the strings.ReplaceAll lint check, it needs Go 1.12 (#458) 2026-10-10 23:17:59 +02:00
Archit Goyal
970f0b7bae
 		fix: accept Unicode minus in NewFromString (#428) 
Some locales and copy-paste sources use U+2212 (−) instead of ASCII '-'.
Normalize it before parsing so NewFromString accepts both.

Closes #318

Co-authored-by: Archit Goyal <jabstack@Archits-MacBook-Air.local>
Co-authored-by: mwoss <wos.mateusz16@gmail.com>
 2026-10-10 23:17:16 +02:00
Mateusz Wos
f658fbf1eb
 		docs: changelog for v1.5.0 (#455) 2026-10-05 14:11:08 +02:00
Mateusz Wos
b2609858ef
 		ci: test on Go 1.26 and 1.27 instead of 1.22 and 1.23 (#454) 2026-10-05 13:53:53 +02:00
Mateusz Wos
d25658fa8d
 		chore: lint with golangci-lint in CI instead of Go Report Card (#453) 2026-10-05 13:53:41 +02:00
Mateusz Wos
fc257b4a95
 		chore: split decimal.go into math.go and encoding.go (#452) 
decimal.go had grown to about 2,900 lines. This moves declarations,
byte for byte with their comments, into:

- math.go: power, exponential, logarithm and trigonometric functions
  and their helpers (Pow, PowWithPrecision, PowInt32, PowBigInt,
  ExpHullAbrham, ExpTaylor, Ln, Sin, Cos, Tan, Atan)
- encoding.go: JSON, text, binary, gob, SQL and Spanner methods, and
  NullDecimal
- const.go: internal constants and lookup tables (zeroInt to twentyInt,
  pow10Table, pow10Uint64, float64Pow10, pow5Int64, pow10, zeros)

Nothing else changes. The go doc -all output is the same.

To follow the history of moved code:

  git blame -C <file>
  git log -L :ExpTaylor:decimal.go aed8543
  git show --color-moved=zebra --color-moved-ws=no <this commit>
 2026-10-05 13:05:34 +02:00
Mateusz Wos
aed8543466
 		fix: RoundCash with a low DivisionPrecision and NullDecimal.Valid after errors (#443) 2026-10-05 11:58:31 +02:00
Mateusz Wos
811854c508
 		perf: faster QuoRem, DivRound, Round, RoundBank, RoundUp, RoundCeil and RoundFloor (#446) 
* perf: faster QuoRem, DivRound, Round, RoundBank, RoundUp, RoundCeil and RoundFloor

* fix: keep the zero representation of RoundCeil and RoundFloor results
 2026-10-05 11:58:08 +02:00
Mateusz Wos
9b6d1186ce
 		perf: raise the ExpHullAbrham sum to its power by squaring (#450) 2026-10-05 11:57:46 +02:00
Mateusz Wos
cc8953c6b3
 		perf: build trig constants once (#449) 2026-10-05 11:57:34 +02:00
Mateusz Wos
84990cbfac
 		perf: faster String, MarshalJSON and NewFromString; reject a sign after the decimal point (#447) 2026-10-05 11:57:10 +02:00
Jake Wang
71ebcfdcdf
 		Fix the scale of the small-input exponential result (#433) 2026-10-05 10:13:05 +02:00
Mateusz Wos
f1d1c0012b
 		perf: int64 fast paths in NumDigits, IntPart, IsInteger and Float64 (#448) 2026-10-04 21:07:30 +02:00
Mateusz Wos
51fe3c95dc
 		fix: keep the zero representation of rescale results (#451) 2026-10-04 21:06:56 +02:00
Mateusz Wos
8a6d7582fa
 		perf: fewer allocations in Add, Sub, Cmp, Sum and Shift (#445) 
* perf: fewer allocations in Add, Sub, Cmp, Sum and Shift
* fix: keep the zero representation of Shift and Sum results
* fix: Shift of zero keeps the zero representation
 2026-10-04 21:06:15 +02:00
Mateusz Wos
e78fe0e8ac
 		perf: use cached powers of ten in rescale, Floor, Ceil and Rat (#444) 2026-10-04 19:56:28 +02:00
Sash
a37fbe42be
 		fix: panic when Shift overflows the exponent (#437) 
* fix: panic when Shift overflows the exponent

Shift added the exponents as int32, so shifting 5 * 10^2147483647
up by one came back as 5 * 10^-2147483648. Mul already panics
when an exponent does not fit.

* Address the Shift overflow review.

The wrap comment was wrong, and the panic cases now use didPanic.
 2026-10-04 17:31:52 +02:00
Mateusz Wos
f6cc580f80
 		docs: explain that NewFromFloat can change large whole numbers (#442) 2026-10-04 10:25:56 +02:00
Mateusz Wos
0911c5f1b5
 		fix: directed rounding always returns the requested exponent (#441) 2026-10-04 09:53:38 +02:00
Amit Mishra
fdefb63ebc
 		fix: normalize exponent in RoundUp/RoundDown/RoundFloor/RoundCeil and support negative precision in Truncate (#426) 
RoundUp, RoundDown, RoundFloor, and RoundCeil all returned the original
decimal (with its original exponent) when the value was already exact at
the requested precision. This caused the result to carry a trailing
exponent that did not match the requested places.

For example, (100.0).RoundUp(0) returned a Decimal with exp=-1 instead
of exp=0, so StringFixedBank(-d.Exponent()) would produce "100.0" rather
than "100".

Fix: when the rescaled value equals the original, return the rescaled
form (which has the canonical exponent) instead of the original.

Truncate previously rejected negative precision values due to a
precision >= 0 guard, silently returning the input unchanged. The
rescale function already uses integer division (Quo, truncating toward
zero), so removing the guard is sufficient to make negative precision
work correctly.

For example, (5432).Truncate(-2) now returns 5400 instead of 5432.

Fixes #390
Fixes #406

Co-authored-by: Amit Mishra <amitmishraaa11@gmail.com>
 2026-10-04 09:47:36 +02:00
Mateusz Wos
71ca20d594
 		fix: limit exponents accepted by NewFromString and UnmarshalBinary (#440) 
* fix: limit exponents accepted by NewFromString and UnmarshalBinary
* fix: rename limit to MaxDecodeExponent and lower its default to 10000
 2026-10-04 09:37:51 +02:00
phuoc14.dev
684fe9e21d
 		fix: Float64 hangs on decimals with huge exponents (#438) 
* fix: Float64 hangs on decimals with huge exponents

Float64 went through Rat(), which builds 10^|exp| as a big.Int. With an
exponent like -1<<30 that never finishes, even when the coefficient is 0.

Zero and values whose magnitude is far outside the float64 range now
return 0 or +/-Inf directly, matching what big.Rat.Float64 would give.

Fixes #226

* docs: explain the Float64 magnitude bounds
 2026-10-04 09:29:49 +02:00
Mateusz Wos
e0621cba7b
 		fix: correctly round Pow results and speed up Pow (#439) 2026-10-04 00:39:46 +02:00
natan streppel
ca47408237
 		fix: ExpTaylor race condition (#414) 2026-08-19 23:07:36 +02:00
Charlie Tonneslan
3090cc487f
 		fix: NumDigits underreports for some exact powers of ten (#425) 
math.Log10(1eN) rounds down to N-1 for several N (15, 24, 28, ...)
because the exact decimal can't survive a float64 round-trip. The
fast path returned int(math.Log10(...)) + 1, so a coefficient like
1000000000000000 (16 digits) came back as 15.

Count digits via int64 division for the IsInt64 branch. The slow
big.Int path is unchanged.

Regression tests cover 1e15 and -1e15 (both via plain literal and
scientific-notation input) and 1<<53 (the old fast-path boundary).

Fixes #420

Signed-off-by: Charlie Tonneslan <cst0520@gmail.com>
 2026-06-29 11:58:29 +02:00
Mateusz Wos
400829b4bf
 		chore: rename AvoidScientificNotation to UseScientificNotation (#416) 2026-03-15 23:07:00 +01:00
Mateusz Wos
6540310a7d
 		Add support for omitzero struct tag (#415) 2026-03-08 23:42:36 +01:00
Joseph Watson
9620fb7d07
 		Add Spanner support for Encode and Decode (#395) 2026-02-13 16:18:44 +01:00
John Dupuy
e1e92bff93
 		TrimTrailingZeros and AvoidScientificNotation bool variables (#389) 
* Added varible TrimTrailingZeros
* Scientific Notation support on serialization to honor negative precision scenarios

---------

Co-authored-by: vasilbekk <vasilbekk@mail.ru>
Co-authored-by: vasilbekk <70901384+vasilbekk@users.noreply.github.com>
 2025-12-25 23:58:32 +01:00
Paulius Ložys
08afb35517
 		UnmarshalJSON, Scan and NewFromString performance improvements (#403) 
* `UnmarshalJSON` and `NewFromString` performance improvements

This PR improves `UnmarshalJSON`  performance by reducing unnecessary allocation caused by `unquoteIfQuoted` function. This also touches on `Scan` method to split `default` case into `string` and `[]byte` cases.

This PR also slightly touches `NewFromString` function by making so scientific notation and dots are checked in a single loop.

* Add malformed scientific notation check and tests
 2025-06-25 01:04:23 +02:00
mwoss
01bb2034de Allow CI jobs on PR creation and sync 2025-06-23 21:07:38 +02:00
Mateusz Woś
a1bdfc355e
 		Release version 1.4.0 (#365) 2024-04-12 16:19:23 +02:00
Mateusz Woś
275e48eaef
 		Add docs section with alternative libraries (#363) 2024-04-12 15:40:04 +02:00
Philip Dubé
dd603cbbbd
 		Support scanning uint64 (#364) 2024-04-12 15:35:56 +02:00
Egor Seredin
80ec940054
 		Add NewFromUint64 constructor (#352) 2024-04-08 16:38:20 +02:00
Mateusz Woś
2fa107d0fe
 		Remove production usage from docs (#362) 2024-04-07 20:33:44 +02:00
Philip Dubé
645a76e5b0
 		Optimize BigInt (#359) 2024-04-05 21:43:23 +02:00
Mateusz Woś
ed8f76e893
 		Drop support for Go versions older than 1.10 (#361) 
* Drop support for Go versions older than 1.10
* Remove 1.18 from test suite
 2024-04-05 21:41:05 +02:00
Mateusz Woś
0e69d5cd53
 		Run CI on both push to origin branches and pull requests (#360) 2024-04-04 16:35:31 +02:00
Philip Dubé
bf7794e1a8
 		Optimize NumDigits method (#356) 2024-04-04 16:14:38 +02:00
Philip Dubé
547861c49b
 		Avoid reallocation of initial slice in MarshalBinary (GobEncode) (#355) 2024-04-03 22:12:19 +02:00
Mateusz Woś
78289cc844
 		Add improved implementation of power operation (#358) 
* Adjust Pow implementation
* Add PowWithPrecision method
* Add PowInt32 method
* Add PowBigInt method
 2024-04-03 00:16:27 +02:00
Mateusz Woś
2b68c56fe0
 		Adjust Ln method to prevent infinity iteration loops (#357) 
* Adjust Ln method to prevent infinity iteration loops
* Add test case for infinity loop
 2024-04-01 22:02:25 +02:00
Dovydas
d00399e161
 		Add NewFromBigRat constructor (#288) 2024-02-19 23:13:43 +01:00
Andrei Tudor Călin
57a340d853
 		Add Compare method which forwards calls to Cmp (#346) 
Given the interface definition

	type Ordered[T any] interface {
		Compare(T) int
	}

And the type constraint T Ordered[T], make decimal.Decimal satisfy this
constraint, so that generic code written against T Ordered[T] can work
with decimal values as smoothly as it works with time.Time values today.

Fixes: #345
 2024-01-24 23:48:15 +01:00
Chris Belsole
b79c571f80
 		Removed unnecessary min function for RescalePair method (#265) 
Co-authored-by: Chris Belsole <chris.belsole@homelight.com>
 2024-01-15 20:56:38 +01:00
Frank
b844c58a71
 		Fix overflow edge case in QuoRem method (#322) 2024-01-15 20:52:54 +01:00
Feras AlSaffar
142a0cf2f2
 		Use Godoc standard to mark deprecated Equals and StringScaled methods(#342) 2024-01-15 20:50:05 +01:00
zlasd
7b4ffbcd3c
 		Fix mod when the divisor is slightly greater than the half of dividend (#312) (#317) 2024-01-10 02:08:45 +01:00
zlasd
1df8fb3015
 		Ensure empty Decimal returns correct zero-value NumDigits (#301) 2023-12-31 13:11:33 +01:00
Jongmin Kim
572d78e32d
 		Fix examples for RoundDown, RoundFloor, RoundUp, and RoundCeil (#341) 2023-12-29 18:47:57 +01:00
mwoss
b4c250139b Update Go version in go.mod to match minimum version required from docs 2023-12-29 12:58:22 +01:00
Mateusz Woś
304c9d6794
 		Update Github Actions libraries to latest working version (#340) 
* Update Github Actions libraries to the latest working version
* Update badge to show status from master branch only
 2023-12-29 12:54:16 +01:00
Mateusz Woś
12e9241da2
 		Add implementation of natural logarithm (#339) 
* Add initial implementation of natural logarithm
* Add constApproxmation struct to represent mathematical constants with their approximations
 2023-12-29 01:59:48 +01:00
mwoss
88705b71ce Reformat documentation to current go standard 2023-12-28 21:05:09 +01:00
Vadim Kulagin
6926256b71
 		Allocate new(big.Int) in Copy method to deeply clone it (#278) 2023-12-27 15:53:43 +01:00
Mateusz Woś
f55dd56454
 		Migrate to Github Actions (#245) 
* Migrate to Github Actions
* Remove architecture param
* Remove Travis config, update readme
 2022-04-18 23:54:26 +02:00
Mateusz Woś
fa3b22f4d4
 		Fix incorrect calculation of decimal modulo (#258) 2021-10-21 11:22:23 +02:00
Mateusz Woś
683f5e1a7e
 		Release version 1.3.1 (#255) 2021-10-20 13:17:51 +02:00
lmittmann
bc96f543c2
 		Reduce memory allocation in case of initialization from big.Int (#252) 
* reduced allocs in NewFromBigInt(...) from 3 -> 2
* remaining `big.NewInt(0).Set(...)` -> `new(big.Int).Set(...)`
 2021-10-20 13:11:07 +02:00
Gaylor Bosson
cd57bf11a4
 		Fix binary marshalling of decimal zero value (#253) 
* Fix binary marshalling of zero value
* Adapt the error message of BinaryUnmarshal
 2021-10-20 12:49:41 +02:00
17 changed files with 5103 additions and 1793 deletions
Download patch file Download diff file Expand all files Collapse all files