mathutils

package

v0.1.0 Latest Latest Go to latest Published: Feb 16, 2026 License: Apache-2.0 Imports: 4 Imported by: 0

Details

Mathematical utility functions for cryptographic and numerical operations.

Random Number Generation - Generate random uint64 values and ranges from a PRNG
Integer Operations - Ceiling division and floor logarithm functions

Designed for cryptographic use with proper rejection sampling for uniform distribution.

Package mathutils provides mathematical utility functions for cryptographic and numerical operations.

See README.md for details.

This section is empty.

This section is empty.

func CeilDiv(numerator, denominator int) int

CeilDiv returns `ceil(numerator/denominator) for integer inputs. Equivalently, it returns `x`, the smallest integer that satisfies `(x*b) >= a`.

func CeilLog2(x int) int

CeilLog2 return ceil(log2(x)).

func FloorLog2(x int) int

FloorLog2 return floor(log2(x)).

func RandomUint64(prng io.Reader) (uint64, error)

RandomUint64 samples a random uint64 from the provided PRNG.

func RandomUint64Range(prng io.Reader, bound uint64) (uint64, error)

RandomUint64Range samples a random uint64 in the range [0, bound) from the provided PRNG.

This section is empty.