smol-bytes 0.1.7

High-performance, clone-efficient byte buffers optimized for small data.
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
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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

use core::{convert::Infallible, str::FromStr};
use std::string::String;

use super::*;

impl<S> From<&str> for Utf8Bytes<S>
where
  RawBytes<S>: ImmutableStorage,
{
  fn from(s: &str) -> Self {
    Self {
      inner: RawBytes::copy_from_slice(s.as_bytes()),
    }
  }
}

impl<S> FromStr for Utf8Bytes<S>
where
  RawBytes<S>: ImmutableStorage,
{
  type Err = Infallible;

  fn from_str(s: &str) -> Result<Self, Self::Err> {
    Ok(Self::from(s))
  }
}

impl<S> From<String> for Utf8Bytes<S>
where
  RawBytes<S>: ImmutableStorage,
{
  fn from(s: String) -> Self {
    Self {
      inner: RawBytes::from(s.into_bytes()),
    }
  }
}

impl<S> TryFrom<RawBytes<S>> for Utf8Bytes<S>
where
  RawBytes<S>: ImmutableStorage,
{
  type Error = core::str::Utf8Error;

  fn try_from(bytes: RawBytes<S>) -> Result<Self, Self::Error> {
    core::str::from_utf8(bytes.as_ref())?;
    Ok(Self { inner: bytes })
  }
}

impl<S> TryFrom<&[u8]> for Utf8Bytes<S>
where
  RawBytes<S>: ImmutableStorage,
{
  type Error = core::str::Utf8Error;

  /// Creates a `Utf8Bytes` from a byte slice, validating UTF-8.
  fn try_from(bytes: &[u8]) -> Result<Self, Self::Error> {
    let s = core::str::from_utf8(bytes)?;
    Ok(Self::from(s))
  }
}

impl<S> From<Utf8Bytes<S>> for RawBytes<S> {
  fn from(value: Utf8Bytes<S>) -> Self {
    value.inner
  }
}

impl<S> From<Utf8Bytes<S>> for String
where
  RawBytes<S>: ImmutableStorage,
{
  fn from(value: Utf8Bytes<S>) -> Self {
    String::from_utf8(value.inner.into()).expect("Utf8Bytes invariant")
  }
}

#[cfg(any(feature = "std", feature = "alloc"))]
const _: () = {
  use std::{boxed::Box, rc::Rc, sync::Arc};

  impl<S> From<Utf8Bytes<S>> for Box<str>
  where
    RawBytes<S>: ImmutableStorage,
  {
    fn from(value: Utf8Bytes<S>) -> Self {
      value.as_str().into()
    }
  }

  impl<S> From<Utf8Bytes<S>> for Arc<str>
  where
    RawBytes<S>: ImmutableStorage,
  {
    fn from(value: Utf8Bytes<S>) -> Self {
      value.as_str().into()
    }
  }

  impl<S> From<Utf8Bytes<S>> for Rc<str>
  where
    RawBytes<S>: ImmutableStorage,
  {
    fn from(value: Utf8Bytes<S>) -> Self {
      value.as_str().into()
    }
  }

  impl<S> From<&String> for Utf8Bytes<S>
  where
    RawBytes<S>: ImmutableStorage,
  {
    fn from(s: &String) -> Self {
      Self::from(s.as_str())
    }
  }

  impl<S> From<Box<str>> for Utf8Bytes<S>
  where
    RawBytes<S>: ImmutableStorage,
  {
    fn from(s: Box<str>) -> Self {
      Self::from(s.as_ref())
    }
  }

  impl<S> From<Arc<str>> for Utf8Bytes<S>
  where
    RawBytes<S>: ImmutableStorage,
  {
    fn from(s: Arc<str>) -> Self {
      Self::from(s.as_ref())
    }
  }

  impl<S> From<Rc<str>> for Utf8Bytes<S>
  where
    RawBytes<S>: ImmutableStorage,
  {
    fn from(s: Rc<str>) -> Self {
      Self::from(s.as_ref())
    }
  }
};