apply a vector of replacements, one after the other.

This is multi-gsub. Use it when it is necessary to process many patterns and replacements in a given order on a vector.

mgsub(pattern, replacement, x, ...)

Arguments

pattern

vector of values to be replaced. A vector filled with patterns as documented in the gsub pattern argument

replacement

vector of replacements, otherwise same as gsub. Length of replacement must be either 1 or same as pattern, otherwise an error results.

x

the vector in which elements are to be replaced, same as gsub

...

Additional arguments to be passed to gsub

Value

vector with pattern replaced by replacement

Author

Jared Harpole <jared.harpole@gmail.com> and Paul Johnson <pauljohn@ku.edu>

Examples

x <- c("Tom", "Jerry", "Elmer", "Bugs")
pattern <- c("Tom", "Bugs")
replacement <- c("Thomas", "Bugs Bunny")
(y <- mgsub(pattern, replacement, x))
#> [1] "Thomas"     "Jerry"      "Elmer"      "Bugs Bunny"
x[1] <- "tom"
(y <- mgsub(pattern, replacement, x, ignore.case = TRUE))
#> [1] "Thomas"     "Jerry"      "Elmer"      "Bugs Bunny"
(y <- mgsub(c("Elmer", "Bugs"), c("Looney Characters"), x, ignore.case = TRUE))
#> [1] "tom"               "Jerry"             "Looney Characters"
#> [4] "Looney Characters"