ic-query 0.55.2

Internet Computer query library for CloudEngine, NNS, SNS, ICRC, system canisters, and public network metadata
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

//! Module: decimal
//!
//! Responsibility: validate unsigned decimal text and compare canonical values.
//! Does not own: field errors, amount bounds, cursor normalization, or numeric conversion.
//! Boundary: preserves arbitrary precision; leading zeroes are valid only in noncanonical text.

#[cfg(any(feature = "cloud-engine-host", feature = "icrc-host"))]
use std::cmp::Ordering;

pub fn is_unsigned_decimal(value: &str) -> bool {
    !value.is_empty() && value.bytes().all(|byte| byte.is_ascii_digit())
}

#[cfg(any(
    feature = "cloud-engine-host",
    feature = "dashboard-host",
    feature = "sns-host"
))]
pub fn is_canonical_unsigned_decimal(value: &str) -> bool {
    is_unsigned_decimal(value) && (value == "0" || !value.starts_with('0'))
}

/// Compare already-validated canonical unsigned decimal strings without parsing them.
#[cfg(any(feature = "cloud-engine-host", feature = "icrc-host"))]
pub fn compare_canonical_unsigned_decimal(left: &str, right: &str) -> Ordering {
    left.len().cmp(&right.len()).then_with(|| left.cmp(right))
}