ion-rs 1.0.0

Implementation of Amazon Ion
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

use crate::lazy::text::buffer::TextBuffer;
use crate::position::Position;
use crate::result::DecodingError;
use crate::{IonError, IonResult};
use smallvec::SmallVec;

/// Attempts to validate a byte sequence as UTF-8 text. If the data is not valid UTF-8, returns
/// an [`IonError`].
///
/// The provided `position` is added to the `IonError` that is constructed if the data is not valid.
pub(crate) trait AsUtf8 {
    fn as_utf8(&self, position: impl Into<Position>) -> IonResult<&str>;
}

impl AsUtf8 for [u8] {
    fn as_utf8(&self, position: impl Into<Position>) -> IonResult<&str> {
        bytes_as_utf8(self, position)
    }
}

impl<const N: usize> AsUtf8 for SmallVec<[u8; N]> {
    fn as_utf8(&self, position: impl Into<Position>) -> IonResult<&str> {
        bytes_as_utf8(self.as_ref(), position)
    }
}

impl AsUtf8 for TextBuffer<'_> {
    fn as_utf8(&self, position: impl Into<Position>) -> IonResult<&str> {
        bytes_as_utf8(self.bytes(), position)
    }
}

fn bytes_as_utf8(bytes: &[u8], position: impl Into<Position>) -> IonResult<&str> {
    std::str::from_utf8(bytes).map_err(|_| {
        let decoding_error =
            DecodingError::new("encountered invalid UTF-8").with_position(position);
        IonError::Decoding(decoding_error)
    })
}