Struct PrecisionBound 

pub struct PrecisionBound { /* private fields */ }

Precision bound calculator for floating-point values.

Given a precision tolerance (e.g., 0.00005 for 4 decimal places), this struct computes the minimum bits needed to represent values within that tolerance, and provides methods to convert floats to their fixed-point representation.

Implementations

impl PrecisionBound

pub fn new(precision: f64) -> Self

Create a new precision bound calculator.

Arguments

• precision - The precision tolerance (e.g., 0.00005 for 4 decimal places)

Example

use buff_rs::precision::PrecisionBound;

let bound = PrecisionBound::new(0.00005);

pub fn precision_bound(&mut self, orig: f64) -> f64

Compute the precision-bounded representation of a float.

This finds the minimum precision representation of orig that is within the precision tolerance.

pub fn cal_length(&mut self, x: f64)

Calculate and update the required bit lengths for a precision-bounded value.

pub fn get_length(&self) -> (u64, u64)

Get the computed integer and decimal bit lengths.

pub fn set_length(&mut self, ilen: u64, dlen: u64)

Set the integer and decimal bit lengths manually.

pub fn fetch_components(&self, bd: f64) -> (i64, u64)

Fetch the integer and decimal components of a precision-bounded float.

pub fn fetch_fixed_aligned(&self, bd: f64) -> i64

Fetch the byte-aligned fixed-point representation.

This converts a float to its fixed-point representation suitable for byte-sliced storage.

pub fn is_bounded(&self, a: f64, b: f64) -> bool

Check if two values are within the precision tolerance.

Trait Implementations

impl Clone for PrecisionBound

fn clone(&self) -> PrecisionBound

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PrecisionBound

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.