Struct bstr::Utf8Chunk[][src]

pub struct Utf8Chunk<'a> { /* fields omitted */ }

A chunk of valid UTF-8, possibly followed by invalid UTF-8 bytes.

This is yielded by the Utf8Chunks iterator, which can be created via the ByteSlice::utf8_chunks method.

The 'a lifetime parameter corresponds to the lifetime of the bytes that are being iterated over.

Implementations

impl<'a> Utf8Chunk<'a>[src]

pub fn valid(&self) -> &'a str[src]

Returns the (possibly empty) valid UTF-8 bytes in this chunk.

This may be empty if there are consecutive sequences of invalid UTF-8 bytes.

pub fn invalid(&self) -> &'a [u8]

Notable traits for &'_ [u8]

impl<'_> Read for &'_ [u8]impl<'_> Write for &'_ mut [u8]
[src]

Returns the (possibly empty) invalid UTF-8 bytes in this chunk that immediately follow the valid UTF-8 bytes in this chunk.

This is only empty when this chunk corresponds to the last chunk in the original bytes.

The maximum length of this slice is 3. That is, invalid UTF-8 byte sequences greater than 1 always correspond to a valid prefix of a valid UTF-8 encoded codepoint. This corresponds to the “substitution of maximal subparts” strategy that is described in more detail in the docs for the ByteSlice::to_str_lossy method.

pub fn incomplete(&self) -> bool[src]

Returns whether the invalid sequence might still become valid if more bytes are added.

Returns true if the end of the input was reached unexpectedly, without encountering an unexpected byte.

This can only be the case for the last chunk.

Auto Trait Implementations

impl<'a> RefUnwindSafe for Utf8Chunk<'a>

impl<'a> Send for Utf8Chunk<'a>

impl<'a> Sync for Utf8Chunk<'a>

impl<'a> Unpin for Utf8Chunk<'a>

impl<'a> UnwindSafe for Utf8Chunk<'a>

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.