Struct std::str::Utf8Error
[−]
[src]
pub struct Utf8Error { valid_up_to: usize, }
Errors which can occur when attempting to interpret a sequence of u8
as a string.
As such, the from_utf8
family of functions and methods for both String
s
and &str
s make use of this error, for example.
Fields
valid_up_to |
Methods
impl Utf8Error
fn valid_up_to(&self) -> usize
Returns the index in the given string up to which valid UTF-8 was verified.
It is the maximum index such that from_utf8(input[..index])
would return Some(_)
.
Examples
Basic usage:
use std::str; // some invalid bytes, in a vector let sparkle_heart = vec![0, 159, 146, 150]; // std::str::from_utf8 returns a Utf8Error let error = str::from_utf8(&sparkle_heart).unwrap_err(); // the first byte is invalid here assert_eq!(1, error.valid_up_to());