const_reify/
dispatch.rs

1//! Match-table dispatch for runtime-to-const-generic bridging.
2
3/// A const-generic type parameterized by a `u64` modulus.
4///
5/// # Examples
6///
7/// ```
8/// use const_reify::{Modular, HasModulus};
9///
10/// let m = Modular::<42>;
11/// assert_eq!(m.modulus(), 42);
12/// ```
13pub struct Modular<const N: u64>;
14
15/// Trait providing access to the const-generic modulus value.
16///
17/// Implemented automatically for all [`Modular<N>`] instances.
18///
19/// # Examples
20///
21/// ```
22/// use const_reify::{Modular, HasModulus};
23///
24/// fn print_modulus(m: &dyn HasModulus) {
25///     println!("modulus = {}", m.modulus());
26/// }
27///
28/// print_modulus(&Modular::<7>);
29/// ```
30pub trait HasModulus {
31    /// Returns the modulus value.
32    fn modulus(&self) -> u64;
33}
34
35impl<const N: u64> HasModulus for Modular<N> {
36    fn modulus(&self) -> u64 {
37        N
38    }
39}
40
41/// Dispatch a runtime `u64` value to the corresponding [`Modular<N>`]
42/// monomorphization, passing it to `f` as a `&dyn HasModulus`.
43///
44/// Supports values in `0..=255`.
45///
46/// # Panics
47///
48/// Panics if `val > 255` with a message indicating the value is out of
49/// the supported range.
50///
51/// # Examples
52///
53/// ```
54/// use const_reify::{reify_const, HasModulus};
55///
56/// let result = reify_const(17, |m| m.modulus());
57/// assert_eq!(result, 17);
58///
59/// // Use it for computation that depends on the const value
60/// let doubled = reify_const(21, |m| m.modulus() * 2);
61/// assert_eq!(doubled, 42);
62/// ```
63pub fn reify_const<F, R>(val: u64, f: F) -> R
64where
65    F: FnOnce(&dyn HasModulus) -> R,
66{
67    macro_rules! dispatch_arm {
68        ($val:expr, $f:expr, $($n:literal),*) => {
69            match $val {
70                $( $n => $f(&Modular::<$n>), )*
71                other => panic!(
72                    "const-reify: value {} is out of supported range 0..=255",
73                    other
74                ),
75            }
76        };
77    }
78
79    dispatch_arm!(
80        val, f, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22,
81        23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45,
82        46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68,
83        69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91,
84        92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111,
85        112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129,
86        130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147,
87        148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165,
88        166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183,
89        184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201,
90        202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219,
91        220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237,
92        238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255
93    )
94}
const_reify/dispatch.rs

const_reify/
dispatch.rs
