Package 'emoji'

Locate the position of emojis in a string

Description

Vectorised over string

Usage

emoji_locate(string)

emoji_locate_all(string)
emoji_locate(string)

emoji_locate_all(string)

Arguments

string

Input vector

Value

For emoji_locate an integer matrix, for emoji_locate_all a list of integer matrices

Examples

string <- paste(c(letters[1:4], emoji_name[1:6]), collapse = " ")

emoji_locate(string)

emoji_locate_all(string)
string <- paste(c(letters[1:4], emoji_name[1:6]), collapse = " ")

emoji_locate(string)

emoji_locate_all(string)

Extract matched emojis from a string

Description

Vectorized over string

Usage

emoji_match(string)

emoji_match_all(string)
emoji_match(string)

emoji_match_all(string)

Arguments

string

Input vector

Value

see stringr::str_match()

Examples

chars <- c(letters[1:4], emoji_name[1:6])

set.seed(1234)

strings <- lapply(1:10, function(x) paste(sample(chars, x), collapse = ""))

extracts <- emoji_match(strings)


extracts <- emoji_match_all(strings)
chars <- c(letters[1:4], emoji_name[1:6])

set.seed(1234)

strings <- lapply(1:10, function(x) paste(sample(chars, x), collapse = ""))

extracts <- emoji_match(strings)


extracts <- emoji_match_all(strings)

Extract Modifiers from Emojis

Description

Extract Modifiers from Emojis

Usage

emoji_modifier_extract(x)
emoji_modifier_extract(x)

Arguments

`x`	Characters, vector of emojis.

Details

This function is vectorized. See emoji_modifiers for full list of modified emojis and their unmodified state.

Value

list of character vectors.

Examples

waving_hands <- emojis$emoji[grepl("waving hand", emojis$name)]
waving_hands

emoji_modifier_extract(waving_hands)

set.seed(1234)
emoji_sample <- sample(emojis$emoji, 10)
emoji_sample

emoji_modifier_extract(emoji_sample)
waving_hands <- emojis$emoji[grepl("waving hand", emojis$name)]
waving_hands

emoji_modifier_extract(waving_hands)

set.seed(1234)
emoji_sample <- sample(emojis$emoji, 10)
emoji_sample

emoji_modifier_extract(emoji_sample)

Remove Modifiers from Emojis

Description

Remove Modifiers from Emojis

Usage

emoji_modifier_remove(x)
emoji_modifier_remove(x)

Arguments

`x`	Characters, vector of emojis.

Details

This function is vectorized. See emoji_modifiers for full list of modified emojis and their unmodified state.

Value

character vector, single emojis will be replaced with un-modified if possible.

Examples

waving_hands <- emojis$emoji[grepl("waving hand", emojis$name)]
waving_hands

emoji_modifier_remove(waving_hands)

set.seed(1234)
emoji_sample <- sample(emojis$emoji, 10)
emoji_sample

emoji_modifier_remove(emoji_sample)
waving_hands <- emojis$emoji[grepl("waving hand", emojis$name)]
waving_hands

emoji_modifier_remove(waving_hands)

set.seed(1234)
emoji_sample <- sample(emojis$emoji, 10)
emoji_sample

emoji_modifier_remove(emoji_sample)

Emoji Modifiers

Description

This data set contains all the emojis with modifiers, their unmodified version as well as a list of the the modifiers.

Usage

emoji_modifiers
emoji_modifiers

Format

tibble with 3 columns and nrow(emoji_modifiers) rows

emoji_modifiers: character representation of the emoji with modifiers
emoji: character representation of the emoji without modifiers
modifiers: list of modifiers

Source

Emoji Names

Description

This vector is a named vector of emojis, where then names are unique descriptive identifiers for the emojis. This vector is well suited to be used as a tool to replace emojis with natural language descriptions.

Usage

emoji_name
emoji_name

Format

named character vector with 4538 elements

Details

Some emojis will appear multiple times since they have multiple names associated with them. Such as "grinning" and "grinning_face" leading to the same emoji.

Source

https://www.unicode.org/reports/tr51/#emoji_data

Summarise your p-values with emoji

Description

Summarise your p-values with emoji

Usage

emoji_p(
  x,
  names = c("laughing", "joy", "grin", "smile", "thinking", "poop"),
  cutpoints = c(1e-05, 0.001, 0.01, 0.05, 0.1),
  legend = FALSE
)
emoji_p(
  x,
  names = c("laughing", "joy", "grin", "smile", "thinking", "poop"),
  cutpoints = c(1e-05, 0.001, 0.01, 0.05, 0.1),
  legend = FALSE
)

Arguments

`x`	A vector of p-values.
`names`	A character vector, for each of the p-value cutoff points. The names are being passed to `emoji()`.
`cutpoints`	A numeric vector of cutpoints between emojis.
`legend`	Logical, denotes if the result should be returned with a legend.

Details

This function is vectorized. The input cutpoints must be 1 shorter than the names input. The input cutpoints should not include 0 or 1 and be in accending order.

Examples

set.seed(1234)
emoji_p(1)
emoji_p(0.1)
emoji_p(0.05)
emoji_p(0.01)
emoji_p(1e-6)

emoji_p(0.01, legend = TRUE)

emoji_p(rbeta(50, 2, 5))

emoji_p(
  runif(100, 0, 0.1),
  names = c("flexed biceps", "hundred points", "thumbs down", "thumbs up"),
  cutpoints = c(0.001, 0.01, 0.05)
)
set.seed(1234)
emoji_p(1)
emoji_p(0.1)
emoji_p(0.05)
emoji_p(0.01)
emoji_p(1e-6)

emoji_p(0.01, legend = TRUE)

emoji_p(rbeta(50, 2, 5))

emoji_p(
  runif(100, 0, 0.1),
  names = c("flexed biceps", "hundred points", "thumbs down", "thumbs up"),
  cutpoints = c(0.001, 0.01, 0.05)
)

Replace emojis in a string

Description

Vectorised over string and replacement

Usage

emoji_replace(string, replacement)

emoji_replace_all(string, replacement)
emoji_replace(string, replacement)

emoji_replace_all(string, replacement)

Arguments

`string`	Input vector
`replacement`	A character vector of replacements. Should either be of length 1 or the same length as `string`. See `stringr::str_replace()` for details

Value

A character vector

Examples

emoji_replace(emoji_name[1], "_emoji_")

string <- paste(c(letters[1:4], emoji_name[1:6]), collapse = " ")

emoji_replace_all(emoji_name[1:6], "_emoji_")
emoji_replace(emoji_name[1], "_emoji_")

string <- paste(c(letters[1:4], emoji_name[1:6]), collapse = " ")

emoji_replace_all(emoji_name[1:6], "_emoji_")

A regular expression to catch all emojis

Description

This regex will capture all fully-qualified and minimally-qualified emojis.

Usage

emoji_rx
emoji_rx

Format

character vector

Source

Keep strings containing an emoji, or find positions

Description

Keep strings containing an emoji, or find positions

Usage

emoji_subset(string, negate = FALSE)

emoji_which(string, negate = FALSE)
emoji_subset(string, negate = FALSE)

emoji_which(string, negate = FALSE)

Arguments

`string`	input vector
`negate`	If `TRUE`, return non-matching elements.

Value

A character vector

Examples

string <- c(letters[1:4], emoji_name[1:6])

emoji_subset(string) == emoji_name[1:6]
emoji_subset(string, negate = TRUE)

emoji_which(string)
emoji_which(string, negate = TRUE)
string <- c(letters[1:4], emoji_name[1:6])

emoji_subset(string) == emoji_name[1:6]
emoji_subset(string, negate = TRUE)

emoji_which(string)
emoji_which(string, negate = TRUE)

Full List of Emojis

Description

This data set is the heart of the emoji package. It contains various information regarding all the avaiable emojis as of v15.0.

Usage

emojis
emojis

Format

tibble with 19 columns and nrow(emojis) rows

emoji: character representation of the emoji
name: name
group: group, e.g. "Smileys & People"
subgroup: sub group, e.g. "face-positive"
version: version where the emoji was introduced
points: Decimal Code Point(s)
nrunes: number of runes the emoji uses
runes: vector of unicode runes, i.e. hexadecimal representations prefixed with "U+"
qualified: Status of the emoji, can be one of 4 types; "component", "fully-qualified", "minimally-qualified", and "unqualified". See details for more.
vendor_* for apple ... windows: logical indicating if the given vendor supports the emoji
keywords: vector of keywords
keywords: vector of aliases

Details

The levels of qualified have the following meaining

component: an Emoji_Component, excluding Regional_Indicators, ASCII, and non-Emoji.
fully-qualified: a fully-qualified emoji (see ED-18 in UTS #51), excluding Emoji_Component
minimally-qualified: a minimally-qualified emoji (see ED-18a in UTS #51)
unqualified: a unqualified emoji (See ED-19 in UTS #51)

Source