Documentation
¶
Overview ¶
Package math provides integer math utilities.
Index ¶
- Constants
- Variables
- func BigMax(x, y *big.Int) *big.Int
- func BigMin(x, y *big.Int) *big.Int
- func BigPow(a, b int64) *big.Int
- func Byte(bigint *big.Int, padlength, n int) byte
- func Exp(base, exponent *big.Int) *big.Int
- func FirstBitSet(v *big.Int) int
- func MustParseBig256(s string) *big.Int
- func MustParseUint64(s string) uint64
- func PaddedBigBytes(bigint *big.Int, n int) []byte
- func ParseBig256(s string) (*big.Int, bool)
- func ParseUint64(s string) (uint64, bool)
- func ReadBits(bigint *big.Int, buf []byte)
- func S256(x *big.Int) *big.Int
- func SafeAdd(x, y uint64) (uint64, bool)
- func SafeMul(x, y uint64) (uint64, bool)
- func SafeSub(x, y uint64) (uint64, bool)
- func U256(x *big.Int) *big.Int
- func U256Bytes(n *big.Int) []byte
- type Decimal256
- type HexOrDecimal256
- type HexOrDecimal64
Constants ¶
const ( MaxInt8 = 1<<7 - 1 MinInt8 = -1 << 7 MaxInt16 = 1<<15 - 1 MinInt16 = -1 << 15 MaxInt32 = 1<<31 - 1 MinInt32 = -1 << 31 MaxInt64 = 1<<63 - 1 MinInt64 = -1 << 63 MaxUint8 = 1<<8 - 1 MaxUint16 = 1<<16 - 1 MaxUint32 = 1<<32 - 1 MaxUint64 = 1<<64 - 1 )
Integer limit values.
Variables ¶
var ( MaxBig256 = new(big.Int).Set(tt256m1) MaxBig63 = new(big.Int).Sub(tt63, big.NewInt(1)) )
Various big integer limit values.
Functions ¶
func Byte ¶ added in v1.6.6
Byte returns the byte at position n, with the supplied padlength in Little-Endian encoding. n==0 returns the MSB Example: bigint '5', padlength 32, n=31 => 5
func Exp ¶ added in v1.5.0
Exp implements exponentiation by squaring. Exp returns a newly-allocated big integer and does not change base or exponent. The result is truncated to 256 bits.
Courtesy @karalabe and @chfast
func FirstBitSet ¶ added in v1.6.0
FirstBitSet returns the index of the first 1 bit in v, counting from LSB.
func MustParseBig256 ¶ added in v1.6.0
MustParseBig256 parses s as a 256 bit big integer and panics if the string is invalid.
func MustParseUint64 ¶ added in v1.6.0
MustParseUint64 parses s as an integer and panics if the string is invalid.
func PaddedBigBytes ¶ added in v1.6.0
PaddedBigBytes encodes a big integer as a big-endian byte slice. The length of the slice is at least n bytes.
func ParseBig256 ¶ added in v1.6.0
ParseBig256 parses s as a 256 bit integer in decimal or hexadecimal syntax. Leading zeros are accepted. The empty string parses as zero.
func ParseUint64 ¶ added in v1.6.0
ParseUint64 parses s as an integer in decimal or hexadecimal syntax. Leading zeros are accepted. The empty string parses as zero.
func ReadBits ¶ added in v1.6.0
ReadBits encodes the absolute value of bigint as big-endian bytes. Callers must ensure that buf has enough space. If buf is too short the result will be incomplete.
func S256 ¶ added in v1.6.0
S256 interprets x as a two's complement number. x must not exceed 256 bits (the result is undefined if it does) and is not modified.
S256(0) = 0 S256(1) = 1 S256(2**255) = -2**255 S256(2**256-1) = -1
Types ¶
type Decimal256 ¶ added in v1.9.23
Decimal256 unmarshals big.Int as a decimal string. When unmarshalling, it however accepts either "0x"-prefixed (hex encoded) or non-prefixed (decimal)
func NewDecimal256 ¶ added in v1.9.23
func NewDecimal256(x int64) *Decimal256
NewDecimal256 creates a new Decimal256
func (*Decimal256) MarshalText ¶ added in v1.9.23
func (i *Decimal256) MarshalText() ([]byte, error)
MarshalText implements encoding.TextMarshaler.
func (*Decimal256) String ¶ added in v1.9.23
func (i *Decimal256) String() string
String implements Stringer.
func (*Decimal256) UnmarshalText ¶ added in v1.9.23
func (i *Decimal256) UnmarshalText(input []byte) error
UnmarshalText implements encoding.TextUnmarshaler.
type HexOrDecimal256 ¶ added in v1.6.0
HexOrDecimal256 marshals big.Int as hex or decimal.
func NewHexOrDecimal256 ¶ added in v1.9.0
func NewHexOrDecimal256(x int64) *HexOrDecimal256
NewHexOrDecimal256 creates a new HexOrDecimal256
func (*HexOrDecimal256) MarshalText ¶ added in v1.6.0
func (i *HexOrDecimal256) MarshalText() ([]byte, error)
MarshalText implements encoding.TextMarshaler.
func (*HexOrDecimal256) UnmarshalJSON ¶ added in v1.11.2
func (i *HexOrDecimal256) UnmarshalJSON(input []byte) error
UnmarshalJSON implements json.Unmarshaler.
It is similar to UnmarshalText, but allows parsing real decimals too, not just quoted decimal strings.
func (*HexOrDecimal256) UnmarshalText ¶ added in v1.6.0
func (i *HexOrDecimal256) UnmarshalText(input []byte) error
UnmarshalText implements encoding.TextUnmarshaler.
type HexOrDecimal64 ¶ added in v1.6.0
type HexOrDecimal64 uint64
HexOrDecimal64 marshals uint64 as hex or decimal.
func (HexOrDecimal64) MarshalText ¶ added in v1.6.0
func (i HexOrDecimal64) MarshalText() ([]byte, error)
MarshalText implements encoding.TextMarshaler.
func (*HexOrDecimal64) UnmarshalJSON ¶ added in v1.11.2
func (i *HexOrDecimal64) UnmarshalJSON(input []byte) error
UnmarshalJSON implements json.Unmarshaler.
It is similar to UnmarshalText, but allows parsing real decimals too, not just quoted decimal strings.
func (*HexOrDecimal64) UnmarshalText ¶ added in v1.6.0
func (i *HexOrDecimal64) UnmarshalText(input []byte) error
UnmarshalText implements encoding.TextUnmarshaler.
Source Files