emoji_search() finds emoji whose Unicode keywords, name or shortcodes
match a query (case-insensitive, substring match). It returns a tidy tibble
of matches with the glyph, name, shortcode, category and the matching
keywords, ready for further inspection or piping into other verbs.
Value
A tibble with columns emoji, name, shortcode, group and
keyword (the keywords of the emoji that contained the match, collapsed
with , ). keyword is the empty string, not NA, when the query matched
the name or a shortcode rather than a keyword. shortcode is NA when
the matched spelling has no alias; see Details.
Details
shortcode is the matched row's first alias, and it is NA when the
matched spelling has none: 189 of the catalogue's 5042 rows carry no
GitHub-style alias at all, so a search that hits one (7 of the 198 rows
emoji_search("face") returns, for instance) has nothing to put in that
column. Use the emoji column for those, or as_emoji_shortcode(), which
is keyed on the emoji rather than on the row and so can borrow the alias of
the glyph's other spelling. For the same reason the two can disagree even
when both answer – see as_emoji_shortcode().
Every non-NA shortcode is a token text_to_emoji() reads, and it
recovers the matched row's emoji exactly. as_emoji() resolves a bare
string by
Unicode name first, so for the 17 strings that name one emoji and alias
another it returns the emoji of that name rather than the row you
searched. They are calendar, camel, cat, cow, dog, horse,
kiss, mouse, pig, rabbit, satellite, snowman, sunglasses,
tiger, train, umbrella and whale; that is the complete set, not a
sample of it. See as_emoji() for why.
See also
text_to_emoji() to turn shortcode back into a glyph;
as_emoji_name() for the name of a glyph.
Examples
emoji_search("happy")
#> # A tibble: 27 × 5
#> emoji name shortcode group keyword
#> <chr> <chr> <chr> <chr> <chr>
#> 1 😀 grinning face grinning Smileys … happy
#> 2 😃 grinning face with big eyes smiley Smileys … happy
#> 3 😄 grinning face with smiling eyes smile Smileys … happy
#> 4 😁 beaming face with smiling eyes grin Smileys … happy
#> 5 😆 grinning squinting face laughing Smileys … happy
#> 6 🤣 rolling on the floor laughing rofl Smileys … happy
#> 7 😂 face with tears of joy joy Smileys … happy
#> 8 🙂 slightly smiling face slightly_smiling_face Smileys … happy
#> 9 😇 smiling face with halo innocent Smileys … happy
#> 10 ☺ smiling face smiling_face Smileys … happy
#> # ℹ 17 more rows
emoji_search("heart")
#> # A tibble: 254 × 5
#> emoji name shortcode group keyword
#> <chr> <chr> <chr> <chr> <chr>
#> 1 😉 winking face wink Smil… heartb…
#> 2 🥰 smiling face with hearts smiling_face_with_three_hea… Smil… heart,…
#> 3 😍 smiling face with heart-eyes heart_eyes Smil… heart-…
#> 4 😘 face blowing a kiss kissing_heart Smil… heart
#> 5 😻 smiling cat with heart-eyes heart_eyes_cat Smil… heart,…
#> 6 💌 love letter love_letter Smil… heart
#> 7 💘 heart with arrow cupid Smil… heart
#> 8 💝 heart with ribbon gift_heart Smil… heart
#> 9 💖 sparkling heart sparkling_heart Smil… heart
#> 10 💗 growing heart heartpulse Smil… heart,…
#> # ℹ 244 more rows