utf8-rune 0.0.1

Lightweight crate that aims at being a building block for libraries that work with UTF-8 data. This crate provides the struct Rune which can thought of in some cases as a drop-in replacement to Rust's char type. This crate also provides a few low-level tools to work with raw pointers of bytes and work with a sequence of bytes to produce valid UTF-8 data. The idea of Rune both borrows from and expands Golang's notion of rune such that rather than representing one 32 bits integer, each `utf8_rune::Rune` represents a set of bytes that, when displayed together represent a single visible UTF-8 character.

UTF8 Rune

Lightweight crate that aims at being a building block for libraries that work with UTF-8 data.

This crate provides the struct Rune which can thought of in some cases as a drop-in replacement to Rust's char type.

This crate also provides a few low-level tools to work with raw pointers of bytes and work with a sequence of bytes to produce valid UTF-8 data.

The idea of Rune both borrows from and expands Golang's notion of rune such that rather than representing one 32 bits integer, each utf8_rune::Rune represents a set of bytes that, when displayed together represent a single visible UTF-8 character.

Examples

`utf8_rune::Rune`

use utf8_rune::Rune;
let rune = Rune::new("👩🏻‍🚒");
assert_eq!(rune.len(), 15);
assert_eq!(rune.as_str(), "👩🏻‍🚒");
assert_eq!(rune.as_bytes(), "👩🏻‍🚒".as_bytes());
assert_eq!(rune.as_bytes(), *&rune);

`utf8_rune::Runes`

use utf8_rune::Runes;
let parts = Runes::new("👩🏻‍🚒👌🏿🧑🏽‍🚒👨‍🚒🌶️🎹💔🔥❤️‍🔥❤️‍🩹");
assert_eq!(
    parts
        .runes().unwrap_or_default()
        .iter()
        .map(|rune| rune.to_string())
        .collect::<Vec<String>>(),
    vec![
        "👩🏻‍🚒",
        "👌🏿",
        "🧑🏽‍🚒",
        "👨‍🚒",
        "🌶️",
        "🎹",
        "💔",
        "🔥",
        "❤️‍🔥",
        "❤️‍🩹",
    ]
);