emojis

✨ Lookup and iterate over emoji names, shortcodes, and groups.

Features

• Lookup up emoji by Unicode value.
• Lookup up emoji by GitHub shortcode.
• Iterate over emojis in recommended order.
• Iterate over emojis in an emoji group. E.g. "Smileys & Emotion" or "Flags".
• Iterate over the skin tones for an emoji.
• Uses Unicode v15.0 emoji specification.

Examples

```rust let hand = emojis::get("🤌")?; // or let hand = emojis::getbyshortcode("pinched_fingers")?;

asserteq!(hand.asstr(), "\u{1f90c}"); asserteq!(hand.name(), "pinched fingers"); asserteq!(hand.unicodeversion(), emojis::UnicodeVersion::new(13, 0)); asserteq!(hand.group(), emojis::Group::PeopleAndBody); asserteq!(hand.shortcode()?, "pinchedfingers"); asserteq!(hand.skintone()?, emojis::SkinTone::Default);

// iterate over all the emojis. let smiley = emojis::iter().next()?; assert_eq!(smiley, "😀");

// iterate and filter out newer emoji versions. let iter = emojis::iter().filter(|e| { e.unicode_version() < emojis::UnicodeVersion::new(13, 0) });

// iterate over all the emojis in a group. let grapes = emojis::Group::FoodAndDrink.emojis().next()?; assert_eq!(grapes, "🍇");

// iterate over the skin tones for an emoji. let raisedhands = emojis::get("🙌🏼")?; let skintones: Vec<_> = raisedhands.skintones()?.map(|e| e.asstr()).collect(); asserteq!(skin_tones, ["🙌", "🙌🏻", "🙌🏼", "🙌🏽", "🙌🏾", "🙌🏿"]); ```

See examples/replace.rs for an example that replaces gemoji names in text.

sh $ echo "launch :rocket:" | cargo run --example replace launch 🚀

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.