utf8-bytes 0.1.1

bytes::Bytes, but UTF-8
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
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

//! A deep UTF-8 string library backed by [`bytes`].

extern crate alloc;

mod bytes;
mod bytes_mut;

use core::fmt;

pub use bytes::Utf8Bytes;
pub use bytes_mut::Utf8BytesMut;

#[derive(Debug, Clone, PartialEq)]
pub struct FromUtf8Error<T> {
    bytes: T,
    error: core::str::Utf8Error,
}

impl<T> FromUtf8Error<T> {
    pub fn inner(&self) -> &T {
        &self.bytes
    }
    pub fn into_inner(self) -> T {
        self.bytes
    }
    pub fn into_utf8_lossy(self) -> Utf8BytesMut
    where
        T: Into<Vec<u8>>,
    {
        let v = self.into_inner().into();
        match String::from_utf8_lossy(&v) {
            std::borrow::Cow::Borrowed(it) => it.into(), // TODO(two allocations)
            std::borrow::Cow::Owned(it) => it.into(),
        }
    }
    pub fn utf8_error(&self) -> core::str::Utf8Error {
        self.error
    }
}

impl<T> From<FromUtf8Error<T>> for core::str::Utf8Error {
    fn from(value: FromUtf8Error<T>) -> Self {
        value.error
    }
}

impl<T: fmt::Debug + Send + Sync + 'static> From<FromUtf8Error<T>> for std::io::Error {
    fn from(value: FromUtf8Error<T>) -> Self {
        std::io::Error::new(std::io::ErrorKind::InvalidData, value)
    }
}

impl<T: fmt::Debug> core::error::Error for FromUtf8Error<T> {
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        self.error.source()
    }
}

impl<T> fmt::Display for FromUtf8Error<T> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> std::fmt::Result {
        self.error.fmt(f)
    }
}