1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/hash.R
\name{hash_emoji}
\alias{hash_emoji}
\alias{hash_raw_emoji}
\alias{hash_obj_emoji}
\title{Emoji hash}
\usage{
hash_emoji(x, size = 3)
hash_raw_emoji(x, size = 3)
hash_obj_emoji(x, size = 3, serialize_version = 2)
}
\arguments{
\item{x}{Character vector. \code{NA} entries will have an \code{NA} hash.}
\item{size}{Number of emojis to use in a hash. Currently it has to
be from 1 through 4.}
\item{serialize_version}{Workspace format version to use, see
\code{\link[base:serialize]{base::serialize()}}.}
}
\value{
\code{hash_emoji()} returns a data frame with columns
\itemize{
\item \code{hash}: the emoji hash, a string of the requested size.
\item \code{emojis}: list column with the emoji characters in character
vectors. Note that an emoji might have multiple code points.
\item \code{text}: text representation of \code{hash}, comma separated.
\item \code{names}: list column with the text representations of \code{emojis}, in
character vectors.
}
\code{hash_raw_emoji()} and \code{hash_obj_emoji()} return a list with
entries:
\itemize{
\item \code{hash}: the emoji hash, a string of requested size,
\item \code{emojis}: the individual emoji characters in a character vector,
\item \code{text}: text representation of \code{hash}, comma separated,
\item \code{names}: names of the emojis, in a character vector.
}
}
\description{
Emoji hash
}
\details{
It uses the first 13 hexadecimal characters (out of the 32) of the MD5
hash of the input, and converts them into an emoji representation.
It uses a manually selected subset of all emojis, that tend to be
displayed correctly.
\subsection{Number of possible hash values}{
cli uses 2280 possible emojis. This is the number of
different hashes you can get for different values of \code{size}:\tabular{rr}{
\code{size} \tab size of hash table space \cr
1 \tab 2,280 \cr
2 \tab 5,198,400 \cr
3 \tab 11,852,352,000 \cr
4 \tab 27,023,362,560,000 \cr
}
}
\code{hash_raw_emoji()} calculates the emoji hash of the bytes
of a raw vector.
\code{hash_obj_emoji()} calculates the emoji hash of an R
object. The object is serialized into a binary vector first.
}
\examples{
hash_emoji(c("foo", NA, "bar", ""))$text
# if you increase `size`, the shorter hash is a prefix of the longer:
hash_emoji("foobar", 1)$text
hash_emoji("foobar", 2)$text
hash_emoji("foobar", 3)$text
hash_emoji("foobar", 4)$text
}
\seealso{
the emoji package for a comprehensive list of emojis
Other hash functions:
\code{\link{hash_animal}()},
\code{\link{hash_md5}()},
\code{\link{hash_sha1}()},
\code{\link{hash_sha256}()},
\code{\link{hash_xxhash}()}
}
\concept{hash functions}
|
