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

use crate::with_region::*;

macro_rules! impl_with_value {
  ($fn_name:ident, $t:ty, $with_region_fn:ident) => {
    /// Replaces the `low` to `high` bit region of `old` with an input up shifted by `low`.
    ///
    /// The `low` and `high` values form an *inclusive* bit range.
    ///
    /// The `replacement` value is up shifted by `low` bits so that it will be
    /// based at the base of the bit region.
    ///
    /// If the `replacement` exceeds the bits allowed by the region they will be
    /// truncated.
    ///
    /// ## Panics
    /// * `low` and `high` can't exceed the number of bits in the type.
    /// * `low` must be less than `high`.
    ///
    /// ```
    /// # use bitfrob::*;
    #[doc = concat!("assert_eq!(",stringify!($fn_name), "(0, 2, 0, 1), 1 << 0);")]
    #[doc = concat!("assert_eq!(",stringify!($fn_name), "(1, 3, 0, 1), 1 << 1);")]
    #[doc = concat!("assert_eq!(",stringify!($fn_name), "(4, 7, 0, 1), 1 << 4);")]
    /// ```
    #[inline]
    #[must_use]
    #[cfg_attr(feature = "track_caller", track_caller)]
    pub const fn $fn_name(low: u32, high: u32, old: $t, replacement: $t) -> $t {
      $with_region_fn(low, high, old, replacement << low)
    }
  };
}

impl_with_value!(u8_with_value, u8, u8_with_region);
impl_with_value!(u16_with_value, u16, u16_with_region);
impl_with_value!(u32_with_value, u32, u32_with_region);
impl_with_value!(u64_with_value, u64, u64_with_region);
impl_with_value!(u128_with_value, u128, u128_with_region);