Struct Utf8Parser

pub struct Utf8Parser { /* private fields */ }

A stateful UTF-8 parser.

Behavior on Errors

Utf8Parser will reset on errors. Example:

use utf8_parser::Utf8Parser;

let mut parser = Utf8Parser::new();
// Utf-8 start byte
assert!(parser.push(0xf0)?.is_none());
// A continuation byte is expected here, but we're pushing an ASCII char
assert!(parser.push(b'a').is_err());
// The state is reset, so this now no longer errors
assert_eq!(parser.push(b'a'), Ok(Some('a')));

Implementations

impl Utf8Parser

pub const fn new() -> Self

Construct a new Utf8Parser

pub const fn push(&mut self, byte: u8) -> Result<Option<char>, Utf8ParserError>

Push a byte into the parser

Trait Implementations

impl Clone for Utf8Parser

fn clone(&self) -> Utf8Parser

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Utf8Parser

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Utf8Parser

fn default() -> Self

Returns the “default value” for a type.