Implement PartialOrd and Ord for Emoji

This allows emojis to be compared and sorted. The order is based on the
Unicode code point order.

Author: rossmacarthur

RELEASES.md

@@ -1,5 +1,12 @@
 # 📝 Release notes
 
+## 0.7.2
+
+*Unreleased*
+
+- [Implement `PartialOrd` and `Ord` for `Emoji`][todo]. This allows emojis to
+  be compared and sorted. The order is based on the Unicode code point order.
+
 ## 0.7.1
 
 *July 31st, 2025*

src/lib.rs

@@ -459,26 +459,43 @@ impl Emoji {
 impl cmp::PartialEq<Emoji> for Emoji {
     #[inline]
     fn eq(&self, other: &Emoji) -> bool {
-        self.emoji == other.emoji
+        self.emoji.eq(other.emoji)
     }
 }
 
 impl cmp::PartialEq<str> for Emoji {
     #[inline]
     fn eq(&self, s: &str) -> bool {
-        self.as_str() == s
+        self.emoji.eq(s)
     }
 }
 
+// TODO: needed?
 impl cmp::PartialEq<&str> for Emoji {
     #[inline]
     fn eq(&self, s: &&str) -> bool {
-        self.as_str() == *s
+        self.emoji.eq(*s)
     }
 }
 
 impl cmp::Eq for Emoji {}
 
+impl cmp::PartialOrd<Emoji> for Emoji {
+    /// Compares two emojis based on their *Unicode* value.
+    #[inline]
+    fn partial_cmp(&self, other: &Emoji) -> Option<cmp::Ordering> {
+        self.emoji.partial_cmp(other.emoji)
+    }
+}
+
+impl cmp::Ord for Emoji {
+    /// Compares two emojis based on their *Unicode* value.
+    #[inline]
+    fn cmp(&self, other: &Emoji) -> cmp::Ordering {
+        self.emoji.cmp(other.emoji)
+    }
+}
+
 impl hash::Hash for Emoji {
     #[inline]
     fn hash<H: hash::Hasher>(&self, state: &mut H) {

tests/smoke.rs

@@ -1,3 +1,5 @@
+use core::cmp::Ordering;
+
 use emojis::{SkinTone, UnicodeVersion};
 
 #[test]
@@ -29,8 +31,29 @@ fn unicode_version_partial_ord() {
 }
 
 #[test]
-fn emoji_partial_eq_str() {
-    assert_eq!(emojis::get("😀").unwrap(), "😀");
+fn emoji_eq() {
+    let a = emojis::get("😀").unwrap();
+    let b = emojis::get("😃").unwrap();
+    assert!(a != b);
+    assert!(b != a);
+    assert!(a == a);
+    assert!(b == b);
+    assert!(a != "😃");
+    assert!(b == "😃");
+}
+
+#[test]
+fn emoji_ord() {
+    let a = emojis::get("😀").unwrap();
+    let b = emojis::get("😃").unwrap();
+    assert_eq!(a.partial_cmp(b), Some(Ordering::Less));
+    assert_eq!(b.partial_cmp(a), Some(Ordering::Greater));
+    assert_eq!(a.partial_cmp(a), Some(Ordering::Equal));
+    assert_eq!(b.partial_cmp(b), Some(Ordering::Equal));
+    assert_eq!(a.cmp(b), Ordering::Less);
+    assert_eq!(b.cmp(a), Ordering::Greater);
+    assert_eq!(a.cmp(a), Ordering::Equal);
+    assert_eq!(b.cmp(b), Ordering::Equal);
 }
 
 #[test]