bitcoin-string 0.1.19

string utilities for the bitcoin system -- BilingualStr, strings representing money
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

// ---------------- [ File: bitcoin-string/src/hex.rs ]
crate::ix!();

pub const util_hexdigit: [i8; 256] = [ 
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    0,1,2,3,4,5,6,7,8,9,-1,-1,-1,-1,-1,-1,
    -1,0xa,0xb,0xc,0xd,0xe,0xf,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,0xa,0xb,0xc,0xd,0xe,0xf,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
    -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, 
];

#[inline]
pub fn hex_digit(c: u8) -> i8 {
    util_hexdigit[c as usize]
}

/// Returns `true` iff every char is hex and the length is even.
pub fn is_hex(s: &str) -> bool {
    if s.is_empty() || s.len() % 2 != 0 {
        return false;
    }
    s.bytes().all(|b| hex_digit(b) >= 0)
}

/// Returns `true` iff `s` is a (possibly “0x”‑prefixed) hex literal.
pub fn is_hex_number(mut s: &str) -> bool {
    if s.starts_with("0x") || s.starts_with("0X") {
        s = &s[2..];
    }
    !s.is_empty() && s.bytes().all(|b| hex_digit(b) >= 0)
}

/// Parse a hexadecimal dump (ignores ASCII whitespace).
pub fn parse_hex(psz: &str) -> Vec<u8> {
    use crate::check::is_space;

    let mut out = Vec::<u8>::with_capacity(psz.len() / 2);
    let bytes = psz.as_bytes();
    let mut idx = 0;

    while idx < bytes.len() {
        /* skip whitespace */
        while idx < bytes.len() && is_space(bytes[idx]) {
            idx += 1;
        }
        if idx + 2 > bytes.len() {
            break;
        }
        let high = hex_digit(bytes[idx]);
        let low = hex_digit(bytes[idx + 1]);
        if high < 0 || low < 0 {
            break;
        }
        out.push(((high as u8) << 4) | (low as u8));
        idx += 2;
    }
    trace!("parse_hex: parsed {} bytes", out.len());
    out
}

/// Lower‑case hex string from raw bytes.
pub fn hex_str(data: &[u8]) -> String {
    const HEXMAP: &[u8; 16] = b"0123456789abcdef";
    let mut out = String::with_capacity(data.len() * 2);
    for &b in data {
        out.push(HEXMAP[(b >> 4) as usize] as char);
        out.push(HEXMAP[(b & 0xF) as usize] as char);
    }
    out
}

#[cfg(test)]
mod tests_hex_utils {
    use super::*;

    #[traced_test]
    fn digit_mapping_roundtrip() {
        for b in 0u8..=255 {
            let d = hex_digit(b);
            if d >= 0 {
                assert_eq!(
                    hex_digit((d as u8) + if d < 10 { b'0' } else { b'a' - 10 }),
                    d
                );
            }
        }
    }

    #[traced_test]
    fn is_hex_and_number_checks() {
        assert!(is_hex("deadBEEF00"));
        assert!(!is_hex("xyz"));

        assert!(is_hex_number("0xdead"));
        assert!(is_hex_number("DEAD"));
        assert!(!is_hex_number("0x"));
        assert!(!is_hex_number("g0"));
    }

    #[traced_test]
    fn parse_and_print_roundtrip() {
        let src = "0123456789abcdef";
        let bytes = parse_hex(src);
        assert_eq!(hex_str(&bytes), src);
    }

    #[traced_test]
    fn ignores_ascii_whitespace() {
        let txt = "  0a 0b\n0c\r0d\t0e";
        let bytes = parse_hex(txt);
        assert_eq!(bytes, [0x0A, 0x0B, 0x0C, 0x0D, 0x0E]);
    }
}