bitcoin-compat 0.1.19

platform specific code and constant assertions for certain assumptions
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

// ---------------- [ File: bitcoin-compat/src/byteswap.rs ]
//! Platform‑independent byte‑swap helpers.
//!
//! These functions mirror the semantics of the classic
//! `bswap_16/32/64` intrinsics on Unix‐like systems, while
//! adding structured tracing so that any misuse can be
//! detected immediately in production builds.

crate::ix!();

//-------------------------------------------[.cpp/bitcoin/src/compat/byteswap.h]

/// Swap the two bytes of a 16‑bit unsigned integer.
///
/// ```text
/// 0xAABB → 0xBBAA
/// ```
#[inline]
pub fn bswap_16(x: u16) -> u16 {
    trace!(target: "compat::byteswap", input = format!("{:#06x}", x), "bswap_16");
    let res = x.swap_bytes();
    trace!(target: "compat::byteswap", output = format!("{:#06x}", res), "bswap_16");
    res
}

/// Swap the four bytes of a 32‑bit unsigned integer.
///
/// ```text
/// 0xAABB_CCDD → 0xDDCC_BBAA
/// ```
#[inline]
pub fn bswap_32(x: u32) -> u32 {
    trace!(target: "compat::byteswap", input = format!("{:#010x}", x), "bswap_32");
    let res = x.swap_bytes();
    trace!(target: "compat::byteswap", output = format!("{:#010x}", res), "bswap_32");
    res
}

/// Swap the eight bytes of a 64‑bit unsigned integer.
///
/// ```text
/// 0x1122_3344_5566_7788 → 0x8877_6655_4433_2211
/// ```
#[inline]
pub fn bswap_64(x: u64) -> u64 {
    trace!(target: "compat::byteswap", input = format!("{:#018x}", x), "bswap_64");
    let res = x.swap_bytes();
    trace!(target: "compat::byteswap", output = format!("{:#018x}", res), "bswap_64");
    res
}