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
|
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/mapValues.R
\name{mapValues}
\alias{mapValues}
\title{Replace values in atomic vectors}
\usage{
mapValues(
x,
from,
to,
regex = FALSE,
ignore.case = FALSE,
perl = FALSE,
fixed = FALSE
)
}
\arguments{
\item{x}{[\code{atomic}]\cr
Atomic vector. If \code{x} is a factor, all replacements work on the levels.}
\item{from}{[\code{atomic}]\cr
Atomic vector with values to replace, same length as \code{to}.}
\item{to}{[\code{atomic}]\cr
Atomic vector with replacements, same length as \code{from}.}
\item{regex}{[\code{logical}]\cr
Use regular expression matching? Default is \code{FALSE}.}
\item{ignore.case}{[\code{logical}]\cr
Argument passed to \code{\link[base]{gsub}}.}
\item{perl}{[\code{logical}]\cr
Argument passed to \code{\link[base]{gsub}}.}
\item{fixed}{[\code{logical}]\cr
Argument passed to \code{\link[base]{gsub}}.}
}
\value{
[\code{atomic}].
}
\description{
Replace values in atomic vectors
}
\details{
Replaces values specified in \code{from} with values in \code{to}.
Regular expression matching can be enabled which calls \code{\link[base]{gsub}} iteratively
on \code{x} to replace all patterns in \code{from} with replacements in \code{to}.
}
\examples{
# replace integers
x = 1:5
mapValues(x, c(2, 3), c(99, 100))
# replace factor levels using regex matching
x = factor(c("aab", "aba", "baa"))
mapValues(x, "a.a", "zzz", regex = TRUE)
}
|
