Add Hrp::{as_bytes, as_str}

Author: thibault-martinez

src/primitives/hrp.rs

@@ -14,7 +14,7 @@ use alloc::string::String;
 use core::cmp::Ordering;
 use core::fmt::{self, Write};
 use core::iter::FusedIterator;
-use core::slice;
+use core::{slice, str};
 
 /// Maximum length of the human-readable part, as defined by BIP-173.
 const MAX_HRP_LEN: usize = 83;
@@ -148,6 +148,16 @@ impl Hrp {
     #[inline]
     pub fn to_lowercase(&self) -> String { self.lowercase_char_iter().collect() }
 
+    /// Returns this human-readable part as bytes.
+    #[inline]
+    pub fn as_bytes(&self) -> &[u8] { &self.buf[..self.size] }
+
+    /// Returns this human-readable part as str.
+    #[inline]
+    pub fn as_str(&self) -> &str {
+        str::from_utf8(&self.buf[..self.size]).expect("we only store ASCII bytes")
+    }
+
     /// Creates a byte iterator over the ASCII byte values (ASCII characters) of this HRP.
     ///
     /// If an uppercase HRP was parsed during object construction then this iterator will yield
@@ -512,4 +522,18 @@ mod tests {
         assert_eq!(TB, Hrp::parse_unchecked("tb"));
         assert_eq!(BCRT, Hrp::parse_unchecked("bcrt"));
     }
+
+    #[test]
+    fn as_str() {
+        let s = "arbitraryhrp";
+        let hrp = Hrp::parse_unchecked(s);
+        assert_eq!(hrp.as_str(), s);
+    }
+
+    #[test]
+    fn as_bytes() {
+        let s = "arbitraryhrp";
+        let hrp = Hrp::parse_unchecked(s);
+        assert_eq!(hrp.as_bytes(), s.as_bytes());
+    }
 }