✨ Lookup and iterate over emoji names, shortcodes, and groups.
- 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
First, add the emojis
crate to your Cargo manifest.
cargo add emojis
Simply use the get()
function to lookup emojis by Unicode value.
let rocket = emojis::get("🚀").unwrap();
Or the get_by_shortcode()
function to lookup emojis by gemoji shortcode.
let rocket = emojis::get_by_shortcode("rocket").unwrap();
These operations take Ο(1) time.
Currently the minimum supported Rust version is 1.60 due to the dependency
on phf
. The policy of this crate is to only increase the MSRV in a
breaking release.
The returned Emoji
struct has various information about the emoji.
let hand = emojis::get("🤌").unwrap();
assert_eq!(hand.as_str(), "\u{1f90c}");
assert_eq!(hand.name(), "pinched fingers");
assert_eq!(hand.unicode_version(), emojis::UnicodeVersion::new(13, 0));
assert_eq!(hand.group(), emojis::Group::PeopleAndBody);
assert_eq!(hand.shortcode(), Some("pinched_fingers"));
assert_eq!(hand.skin_tone(), Some(emojis::SkinTone::Default));
Another common operation is iterating over the skin tones of an emoji.
let raised_hands = emojis::get("🙌🏼").unwrap();
let skin_tones: Vec<_> = raised_hands.skin_tones().unwrap().map(|e| e.as_str()).collect();
assert_eq!(skin_tones, ["🙌", "🙌🏻", "🙌🏼", "🙌🏽", "🙌🏾", "🙌🏿"]);
You can use the iter()
function to iterate over all emojis (only
includes the default skin tone versions).
let smiley = emojis::iter().next().unwrap();
assert_eq!(smiley, "😀");
It is recommended to filter the list by the maximum Unicode version that you wish to support.
let iter = emojis::iter().filter(|e| {
e.unicode_version() < emojis::UnicodeVersion::new(13, 0)
});
Using the Group
enum you can iterate over all emojis in a group.
let grapes = emojis::Group::FoodAndDrink.emojis().next().unwrap();
assert_eq!(grapes, "🍇");
See examples/replace.rs for an example that replaces gemoji names in text.
$ echo "launch :rocket:" | cargo run --example replace
launch 🚀
This project is distributed under the terms of both the MIT license and the Apache License (Version 2.0).
See LICENSE-APACHE and LICENSE-MIT for details.