mapValues: Replace values in atomic vectors
In berndbischl/BBmisc: Miscellaneous Helper Functions for B. Bischl

mapValues

R Documentation

Replace values in atomic vectors

Description

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`.

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.

Value

[atomic].

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)

berndbischl/BBmisc documentation built on Jan. 6, 2023, 12:32 p.m.