decimal

package

v0.1.0-alpha.8 Latest Latest Go to latest Published: Oct 29, 2026 License: Apache-2.0 Imports: 9 Imported by: 0

Details

Package decimal implements the bounded base-ten pipeline numeric contract.

View Source

const MaxPrecision = 38

View Source

var ErrConversion = xerror.New(xerror.KindInvalidInput, "PIPELINE_DECIMAL_CONVERSION", "invalid bounded decimal conversion")

func ValidateDeclaration(precision, scale int) error

type Value struct {
	// contains filtered or unexported fields
}

Value is immutable; operations allocate a destination and never mutate operands. The zero value represents decimal zero.

func Cast(value any) (Value, error)

Cast exposes the already-rounded float's shortest decimal representation.

func From(value any) (Value, error)

From accepts exact decimal tokens and integers. Binary floats require Cast.

func Parse(text string) (Value, error)

Parse rejects hostile tokens before coefficient allocation and never rounds input.

func (v Value) Cmp(other Value) int

func (v Value) EstimatedBytes() int64

EstimatedBytes includes coefficient storage as well as the serialized token.

func (v Value) Inexact() bool

func (v Value) MarshalJSON() ([]byte, error)

func (v Value) Operation(other Value, operation string) (Value, error)

func (v Value) Quantize(precision, scale int) (Value, error)

func (v Value) Rat() *big.Rat

Rat is exact and bounded by the decimal exponent contract.

func (v Value) Rounded() bool

func (v Value) String() string