dragonbox 0.1.12

Fast floating point to string conversion
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

// Translated from C++ to Rust. The original C++ code can be found at
// https://github.com/jk-jeon/dragonbox and carries the following license:
//
// Copyright 2020-2025 Junekey Jeon
//
// The contents of this file may be used under the terms of
// the Apache License v2.0 with LLVM Exceptions.
//
//    (See accompanying file LICENSE-Apache or copy at
//     https://llvm.org/foundation/relicensing/LICENSE.txt)
//
// Alternatively, the contents of this file may be used under the terms of
// the Boost Software License, Version 1.0.
//    (See accompanying file LICENSE-Boost or copy at
//     https://www.boost.org/LICENSE_1_0.txt)
//
// Unless required by applicable law or agreed to in writing, this software
// is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied.

use crate::wuint;

// Replace n by floor(n / 10^N).
// Returns true if and only if n is divisible by 10^N.
// Precondition: n <= 10^(N+1)
pub(crate) fn check_divisibility_and_divide_by_pow10(n: &mut u32) -> bool {
    const N: u32 = 2;
    debug_assert!(*n <= crate::compute_power32::<{ N + 1 }>(10));

    struct Info;
    impl Info {
        const MAGIC_NUMBER: u32 = 656;
        const SHIFT_AMOUNT: i32 = 16;
    }

    let prod = *n * Info::MAGIC_NUMBER;

    const MASK: u32 = (1 << Info::SHIFT_AMOUNT) - 1;
    let result = (prod & MASK) < Info::MAGIC_NUMBER;

    *n = prod >> Info::SHIFT_AMOUNT;
    result
}

// Compute floor(n / 10^N) for small N.
// Precondition: n <= n_max
pub(crate) fn divide_by_pow10<const N: u32, const N_MAX: u64>(n: u64) -> u64 {
    // Specialize for 64-bit division by 10.
    // Without the bound on n_max (which compilers these days never leverage),
    // the minimum needed amount of shift is larger than 64.
    if N == 1 && N_MAX <= 4611686018427387908 {
        return wuint::umul128_upper64(n, 1844674407370955162);
    }
    // Specialize for 64-bit division by 1000.
    // Without the bound on n_max (which compilers these days never leverage),
    // the smallest magic number for this computation does not fit into 64-bits.
    if N == 3 && N_MAX <= 15534100272597517998 {
        return wuint::umul128_upper64(n, 4722366482869645214) >> 8;
    }
    let divisor = const { crate::compute_power64::<N>(10) };
    n / divisor
}