qubit-value 0.12.1

Type-safe containers for single, multi-valued, and named runtime values
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

// =============================================================================
//    Copyright (c) 2025 - 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Canonical hashing for [`bigdecimal::BigDecimal`].

use std::hash::Hash;
use std::hash::Hasher;

use bigdecimal::BigDecimal;
use num_bigint::Sign;

/// Hashes a decimal by its normalized coefficient and effective scale.
///
/// The work and temporary allocation are proportional to the stored
/// coefficient digit count and do not depend on the absolute scale.
///
/// # Parameters
///
/// * `value` - Decimal whose representation is normalized for hashing.
/// * `state` - Destination hasher.
///
/// # Type Parameters
///
/// * `H` - Hasher receiving the normalized decimal identity.
pub(crate) fn hash_big_decimal<H: Hasher>(value: &BigDecimal, state: &mut H) {
    let (coefficient, scale) = value.as_bigint_and_scale();
    if coefficient.sign() == Sign::NoSign {
        0_u8.hash(state);
        return;
    }

    let coefficient = coefficient.to_str_radix(10);
    let normalized = coefficient.trim_end_matches('0');
    let trailing_zero_count = coefficient.len() - normalized.len();
    let effective_scale = i128::from(scale) - trailing_zero_count as i128;

    1_u8.hash(state);
    normalized.hash(state);
    effective_scale.hash(state);
}