ps-str 0.1.0-5

String transcoding library
Documentation 
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

use arcstr::ArcStr;

use crate::{ArcStrUtf8Encoder, Utf8Encoder};

impl<T: AsRef<[u8]>> ArcStrUtf8Encoder for T {
    /// Converts a byte sequence into an [`ArcStr`], replacing invalid bytes
    /// with fallback characters.
    ///
    /// Entirely valid UTF-8 input is copied into the [`ArcStr`] directly;
    /// input containing invalid bytes is decoded via
    /// [`Utf8Encoder::to_utf8_string`] first.
    ///
    /// # Example
    ///
    /// ```
    /// use ps_str::ArcStrUtf8Encoder;
    ///
    /// let bytes = b"Hello\xFFWorld";
    /// let result = bytes.to_utf8_arcstr();
    ///
    /// assert_eq!(result, "Hello˙World");
    /// ```
    fn to_utf8_arcstr(&self) -> ArcStr {
        let bytes = self.as_ref();

        std::str::from_utf8(bytes)
            .map_or_else(|_| ArcStr::from(bytes.to_utf8_string()), ArcStr::from)
    }
}