gnat 0.1.10

Type-level numbers without extra bounds
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

use super::*;

#[apply(nat_expr)]
pub type _LogUncheckedNormRec<B: NatExpr, N: NatExpr> = _LogUnchecked<
    B,
    // Normalize recursive argument
    crate::Eval<_DivUnchecked<N, B>>,
>;
#[apply(nat_expr)]
pub type _LogUnchecked<B: NatExpr, N: NatExpr> = If<
    //
    _Lt<N, B>,
    crate::lit!(0),
    _Inc<_LogUncheckedNormRec<B, N>>,
>;
#[apply(nat_expr)]
pub type _Log<B: NatExpr, N: NatExpr> = If<
    // Check B > 1 and N > 0
    _And<_H<B>, N>,
    _LogUnchecked<B, N>,
    // Fallback value
    crate::lit!(0),
>;

/// Type-level [`ilog`](u128::ilog)
//
/// The base is taken as the first argument.
///
/// # Examples
#[doc = op_examples!(
    Log,
    (5, 6) == 1,
    (5, 4) == 0,
)]
/// If the logarithm is undefined, the result is 0:
#[doc = op_examples!(
    Log,
    (0, 10) == 0,
    (1, 10) == 0,
    (5, 0) == 0,
)]
#[apply(opaque)]
#[apply(test_op!
    test_ilog,
    N.ilog(B).into(),
    2..,
    1..,
)]
pub type Log<B, N> = _Log;

#[apply(nat_expr)]
pub type _BaseLen<B: NatExpr, N: NatExpr> = If<
    // Half of B is zero iff B <= 1
    _H<B>,
    If<
        N,
        // If B > 1 and N > 0, length in base B is just ILog + 1
        _Inc<_LogUnchecked<B, N>>,
        // The length of 0 is 1
        crate::lit!(1),
    >,
    // If B = 1 then return unary length, if B = 0 then return fallback
    If<B, N, crate::lit!(0)>,
>;

/// Calculates the length of a number in an arbitrary base.
///
/// The base is taken as the first argument.
#[apply(opaque)]
#[apply(test_op! test_base_len, {
    let mut n = N;
    let mut r = 1;
    while n >= B {
        r += 1;
        n /= B;
    }
    r
}, 2..)]
/// # Examples
/// Calculating the length of `to_string`:
#[doc = op_examples!(
    BaseLen,
    (10, 0) == 1,
    (10, 10) == 2,
    (10, 99) == 2,
)]
/// Base 1 uses unary length:
#[doc = op_examples!(
    BaseLen,
    (1, 3) == 3,
    (1, 10) == 10,
)]
/// Base 0 always gives 0:
#[doc = op_examples!(
    BaseLen,
    (0, 0) == 0,
    (0, 5) == 0,
)]
pub type BaseLen<B, N> = _BaseLen;