Find emojis by codepoint

Now you can find emojis by codepoint using the `U+ABCD` notation, for
example `U+1F976` (or `u+1f976`) will find 🥶.

A nice side effect is that you can show all the emojis having a VS-16
codepoint with `u+fe0f` and all the emojis having a ZWJ with `u+200d`.

This is all implemented in EmojiDb::findEmojis(): there needs to be
a single needle, its size needs to be at least three, and it must start
with `u+` (all needles are lowercase).

Signed-off-by: Philippe Proulx <[email protected]>

Author: eepp

README.adoc

@@ -11,7 +11,7 @@ endif::env-github[]
 
 = jome 😏
 Philippe Proulx <eepp.ca>
-8 April 2025
+14 April 2025
 
 https://github.com/eepp/jome/releases/tag/v1.2.1[image:https://img.shields.io/github/v/release/eepp/jome?display_name=release[GitHub Release]]
 https://aur.archlinux.org/packages/jome[image:https://img.shields.io/aur/version/jome?&label=AUR[AUR Version]]
@@ -230,6 +230,8 @@ The format of a query is 1️⃣ of:
 * `_TERMS_`
 * `_CAT_/`
 * `_CAT_/_TERMS_`
+* `_CODEPOINT_`
+* `_CAT_/_CODEPOINT_`
 
 where:
 
@@ -242,6 +244,11 @@ where:
 For an emoji to be part of the results, its name and keywords must
 contain _all_ the 🔍 terms.
 
+`_CODEPOINT_`::
+    A single Unicode codepoint using the standard `U+__ABCD__` notation.
+
+Everything is 💼-insensitive.
+
 [[select]]
 === Select and ✅ an emoji
 

jome/emoji-db.cpp

@@ -24,13 +24,28 @@
 #include "emoji-db.hpp"
 
 namespace jome {
+namespace {
+
+QString cpStr(const Emoji::Codepoints& codepoints)
+{
+    QStringList parts;
+
+    for (const auto cp : codepoints) {
+        parts.append(qFmtFormat("u+{:x}", cp));
+    }
+
+    return parts.join(' ');
+}
+
+} // namespace
 
 Emoji::Emoji(QString str, QString name,
              std::unordered_set<QString>&& keywords, const bool hasSkinToneSupport,
              const EmojiVersion version) :
     _str {std::move(str)},
     _name {std::move(name)},
     _lcName {_name.toLower()},
+    _cpStr {cpStr(this->codepoints())},
     _keywords {std::move(keywords)},
     _hasSkinToneSupport {hasSkinToneSupport},
     _version {version}
@@ -427,6 +442,31 @@ void EmojiDb::findEmojis(QString catName, const QString& needlesStr,
     _tmpFindResults.clear();
     _tmpFindResultEmojis.clear();
 
+    // handle specific codepoint search
+    if (needles.size() == 1 && needles.first().size() >= 3 && needles.first().startsWith("u+")) {
+        for (auto& cat : _cats) {
+            if (cat->isRecent()) {
+                // exclude "Recent" category
+                continue;
+            }
+
+            if (!catName.isEmpty() && !cat->lcName().contains(catName)) {
+                // we don't even want to search this category
+                continue;
+            }
+
+            for (auto emoji : cat->emojis()) {
+                if (emoji->codepointStr().contains(needles.first()) &&
+                        _tmpFindResultEmojis.count(emoji) == 0) {
+                    results.push_back(emoji);
+                    _tmpFindResultEmojis.insert(emoji);
+                }
+            }
+        }
+
+        return;
+    }
+
     auto pos = 0U;
 
     for (auto& cat : _cats) {

jome/emoji-db.hpp

@@ -120,6 +120,19 @@ class Emoji final
         return _lcName;
     }
 
+    /*
+     * Codepoint string (lowercase).
+     *
+     * For example: `u+2600 u+fe0f`.
+     *
+     * The purpose of this string is to be able to find an emoji quickly
+     * by codepoint with the `U+ABCD` notation.
+     */
+    const QString& codepointStr() const noexcept
+    {
+        return _cpStr;
+    }
+
     /*
      * Keywords of this emoji.
      */
@@ -148,6 +161,7 @@ class Emoji final
     const QString _str;
     const QString _name;
     const QString _lcName;
+    const QString _cpStr;
     const std::unordered_set<QString> _keywords;
     const bool _hasSkinToneSupport;
     const EmojiVersion _version;

man/jome.1

@@ -2,12 +2,12 @@
 .\"     Title: vlttng
 .\"    Author: [see the "AUTHOR(S)" section]
 .\" Generator: Asciidoctor 2.0.23
-.\"      Date: 8 April 2025
+.\"      Date: 14 April 2025
 .\"    Manual: JOME
 .\"    Source: JOME
 .\"  Language: English
 .\"
-.TH "JOME" "1" "8 April 2025" "JOME" "JOME"
+.TH "JOME" "1" "14 April 2025" "JOME" "JOME"
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .ss \n[.ss] 0
@@ -203,6 +203,28 @@ The format of a query is one of:
 \fICAT\fP/\fITERMS\fP
 .RE
 .sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.  sp -1
+.  IP \(bu 2.3
+.\}
+\fICODEPOINT\fP
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.  sp -1
+.  IP \(bu 2.3
+.\}
+\fICAT\fP/\fICODEPOINT\fP
+.RE
+.sp
 where:
 .sp
 \fICAT\fP
@@ -217,6 +239,14 @@ Space\-separated list of search terms.
 For an emoji to be part of the results, its name and keywords
 must contain ALL the searched terms.
 .RE
+.sp
+\fICODEPOINT\fP
+.RS 4
+A single Unicode codepoint using the standard \fBU\fP+\fIABCD\fP
+notation.
+.RE
+.sp
+Everything is case\-insensitive.
 .SS "Select and accept an emoji"
 .sp
 To select an emoji, use the following keys:

man/jome.1.adoc

@@ -1,5 +1,5 @@
 = vlttng(1)
-:revdate: 8 April 2025
+:revdate: 14 April 2025
 :docdate: {revdate}
 :doctype: manpage
 :manmanual: JOME
@@ -120,6 +120,8 @@ The format of a query is one of:
 * __TERMS__
 * __CAT__/
 * __CAT__/__TERMS__
+* __CODEPOINT__
+* __CAT__/__CODEPOINT__
 
 where:
 
@@ -132,6 +134,12 @@ __TERMS__::
 For an emoji to be part of the results, its name and keywords
 must contain ALL the searched terms.
 
+__CODEPOINT__::
+    A single Unicode codepoint using the standard **U**+__ABCD__
+    notation.
+
+Everything is case-insensitive.
+
 === Select and accept an emoji
 
 To select an emoji, use the following keys: