Crate encode_unicode

Miscellaneous UTF-8 and UTF-16 types and methods.

Optional features:

• #![no_std]-mode: There are a few differences:

  • Error doesn’t exist, but description() is made available as an inherent impl.
  • Extend/FromIterator-implementations for String/Vec<u8>/Vec<u16> are missing.
  • There is no io, so Utf8Iterator and Utf8CharSplitter doesn’t implement Read.

  This feature is enabled by setting default-features=false in Cargo.toml: encode_unicode = {version="0.3.4", default-features=false}

• Integration with the ascii crate:
  Convert Utf8Char and Utf16Char to and from ascii::AsciiChar.

The minimum supported version of Rust is 1.15, older versions might work now but can break with a minor update.

crates.io page
github repository

Modules

• error
  Errors returned by various conversion methods in this crate.
• iterator
  Iterator types that you should rarely need to name

Structs

• Utf8Char
  An unicode codepoint stored as UTF-8.
• Utf8Iterator
  Read or iterate over the bytes of the UTF-8 representation of a codepoint.
• Utf16Char
  An unicode codepoint stored as UTF-16.
• Utf16Iterator
  Iterate over the units of the UTF-16 representation of a codepoint.

Traits

• CharExt
  Extension trait for char that adds methods for converting to and from UTF-8 or UTF-16.
• IterExt
  Iterator methods that convert between u8s and Utf8Char or u16s and Utf16Char
• SliceExt
  Methods for iterating over u8 and u16 slices as UTF-8 or UTF-16 characters.
• StrExt
  Adds .utf8chars() and .utf16chars() iterator constructors to &str.
• U8UtfExt
  Methods for working with u8s as UTF-8 bytes.
• U16UtfExt
  Methods for working with u16s as UTF-16 units.

Functions

• iter_bytes
  Converts an iterator of Utf8Char (or &Utf8Char) to an iterator of u8s.
  Is equivalent to calling .flat_map() on the original iterator, but the returned iterator is ~40% faster.
• iter_units
  Converts an iterator of Utf16Char (or &Utf16Char) to an iterator of u16s.
  Is equivalent to calling .flat_map() on the original iterator, but the returned iterator is about twice as fast.