exact

Documentation

Overview

Package exact implements mathematically exact values and operations for untyped Go constant values.

A special Unknown value may be used when a constant value is unknown due to an error; operations on unknown values produce unknown values.

Index

• func BitLen(x Value) int
• func BoolVal(x Value) bool
• func Bytes(x Value) []byte
• func Compare(x Value, op token.Token, y Value) bool
• func Float64Val(x Value) (float64, bool)
• func Int64Val(x Value) (int64, bool)
• func Sign(x Value) int
• func StringVal(x Value) string
• func Uint64Val(x Value) (uint64, bool)
• type Kind
• type Value
  • func BinaryOp(x Value, op token.Token, y Value) Value
  • func Denom(x Value) Value
  • func Imag(x Value) Value
  • func MakeBool(b bool) Value
  • func MakeFloat64(x float64) Value
  • func MakeFromBytes(bytes []byte) Value
  • func MakeFromLiteral(lit string, tok token.Token) Value
  • func MakeImag(x Value) Value
  • func MakeInt64(x int64) Value
  • func MakeString(s string) Value
  • func MakeUint64(x uint64) Value
  • func MakeUnknown() Value
  • func Num(x Value) Value
  • func Real(x Value) Value
  • func Shift(x Value, op token.Token, s uint) Value
  • func UnaryOp(op token.Token, y Value, size int) Value

Functions

func BitLen

func BitLen(x Value) int

BitLen returns the number of bits required to represent the absolute value x in binary representation; x must be an Int or an Unknown. If x is Unknown, the result is 0.

func BoolVal

func BoolVal(x Value) bool

BoolVal returns the Go boolean value of x, which must be a Bool or an Unknown. If x is Unknown, the result is false.

func Bytes

func Bytes(x Value) []byte

Bytes returns the bytes for the absolute value of x in little- endian binary representation; x must be an Int.

func Compare

func Compare(x Value, op token.Token, y Value) bool

Compare returns the result of the comparison x op y. The comparison must be defined for the operands. If one of the operands is Unknown, the result is false.

func Float64Val

func Float64Val(x Value) (float64, bool)

Float64Val returns the nearest Go float64 value of x and whether the result is exact; x must be numeric but not Complex, or Unknown. If x is Unknown, the result is (0, false).

func Int64Val

func Int64Val(x Value) (int64, bool)

Int64Val returns the Go int64 value of x and whether the result is exact; x must be an Int or an Unknown. If the result is not exact, its value is undefined. If x is Unknown, the result is (0, false).

func Sign

func Sign(x Value) int

Sign returns -1, 0, or 1 depending on whether x < 0, x == 0, or x > 0; x must be numeric or Unknown. For complex values x, the sign is 0 if x == 0, otherwise it is != 0. If x is Unknown, the result is 1.

func StringVal

func StringVal(x Value) string

StringVal returns the Go string value of x, which must be a String or an Unknown. If x is Unknown, the result is "".

func Uint64Val

func Uint64Val(x Value) (uint64, bool)

Uint64Val returns the Go uint64 value of x and whether the result is exact; x must be an Int or an Unknown. If the result is not exact, its value is undefined. If x is Unknown, the result is (0, false).

Types

type Kind

type Kind int

Kind specifies the kind of value represented by a Value.

const (
	// unknown values
	Unknown Kind = iota

	// non-numeric values
	Bool
	String

	// numeric values
	Int
	Float
	Complex
)

type Value

type Value interface {
	// Kind returns the value kind; it is always the smallest
	// kind in which the value can be represented exactly.
	Kind() Kind

	// String returns a human-readable form of the value.
	String() string
	// contains filtered or unexported methods
}

A Value represents a mathematically precise value of a given Kind.

func BinaryOp

func BinaryOp(x Value, op token.Token, y Value) Value

BinaryOp returns the result of the binary expression x op y. The operation must be defined for the operands. If one of the operands is Unknown, the result is Unknown. To force integer division of Int operands, use op == token.QUO_ASSIGN instead of token.QUO; the result is guaranteed to be Int in this case. Division by zero leads to a run-time panic.

func Denom

func Denom(x Value) Value

Denom returns the denominator of x; x must be Int, Float, or Unknown. If x is Unknown, the result is Unknown, otherwise it is an Int >= 1.

func Imag

func Imag(x Value) Value

Imag returns the imaginary part of x, which must be a numeric or unknown value. If x is Unknown, the result is Unknown.

func MakeBool

func MakeBool(b bool) Value

MakeBool returns the Bool value for x.

func MakeFloat64

func MakeFloat64(x float64) Value

MakeFloat64 returns the numeric value for x. If x is not finite, the result is unknown.

func MakeFromBytes

func MakeFromBytes(bytes []byte) Value

MakeFromBytes returns the Int value given the bytes of its little-endian binary representation. An empty byte slice argument represents 0.

func MakeFromLiteral

func MakeFromLiteral(lit string, tok token.Token) Value

MakeFromLiteral returns the corresponding integer, floating-point, imaginary, character, or string value for a Go literal string. The result is nil if the literal string is invalid.

func MakeImag

func MakeImag(x Value) Value

MakeImag returns the numeric value x*i (possibly 0); x must be Int, Float, or Unknown. If x is Unknown, the result is Unknown.

func MakeInt64

func MakeInt64(x int64) Value

MakeInt64 returns the Int value for x.

func MakeString

func MakeString(s string) Value

MakeString returns the String value for x.

func MakeUint64

func MakeUint64(x uint64) Value

MakeUint64 returns the Int value for x.

func MakeUnknown

func MakeUnknown() Value

MakeUnknown returns the Unknown value.

func Num

func Num(x Value) Value

Num returns the numerator of x; x must be Int, Float, or Unknown. If x is Unknown, the result is Unknown, otherwise it is an Int.

func Real

func Real(x Value) Value

Real returns the real part of x, which must be a numeric or unknown value. If x is Unknown, the result is Unknown.

func Shift

func Shift(x Value, op token.Token, s uint) Value

Shift returns the result of the shift expression x op s with op == token.SHL or token.SHR (<< or >>). x must be an Int or an Unknown. If x is Unknown, the result is x.

func UnaryOp

func UnaryOp(op token.Token, y Value, size int) Value

UnaryOp returns the result of the unary expression op y. The operation must be defined for the operand. If size >= 0 it specifies the ^ (xor) result size in bytes. If y is Unknown, the result is Unknown.