Replace values in atomic vectors

Usage

mapValues(
  x,
  from,
  to,
  regex = FALSE,
  ignore.case = FALSE,
  perl = FALSE,
  fixed = FALSE
)

Arguments

x: [atomic]
Atomic vector. If x is a factor, all replacements work on the levels.
from: [atomic]
Atomic vector with values to replace, same length as to.
to: [atomic]
Atomic vector with replacements, same length as from.
regex: [logical]
Use regular expression matching? Default is FALSE.
ignore.case: [logical]
Argument passed to gsub.
perl: [logical]
Argument passed to gsub.
fixed: [logical]
Argument passed to gsub.

Value

[atomic].

Details

Replaces values specified in from with values in to. Regular expression matching can be enabled which calls gsub iteratively on x to replace all patterns in from with replacements in to.

Examples

# replace integers
x = 1:5
mapValues(x, c(2, 3), c(99, 100))
#> [1]   1  99 100   4   5

# replace factor levels using regex matching
x = factor(c("aab", "aba", "baa"))
mapValues(x, "a.a", "zzz", regex = TRUE)
#> [1] aab zzz baa
#> Levels: aab zzz baa