misty (version 0.5.0)

chr.gsub: Multiple Pattern Matching And Replacements

Description

This function is a multiple global string replacement wrapper that allows access to multiple methods of specifying matches and replacements.

Usage

chr.gsub(pattern, replacement, x, recycle = FALSE, ...)

Value

Return a character vector of the same length and with the same attributes as x (after possible coercion to character).

Arguments

pattern

a character vector with character strings to be matched.

replacement

a character vector equal in length to pattern or of length one which are a replacement for matched patterns.

x

a character vector where matches and replacements are sought.

recycle

logical: if TRUE, replacement is recycled if lengths differ.

...

additional arguments to pass to the regexpr or sub function.

Author

Mark Ewing

References

Mark Ewing (2019). mgsub: Safe, Multiple, Simultaneous String Substitution. R package version 1.7.1. https://CRAN.R-project.org/package=mgsub

See Also

chr.omit, chr.trim

Examples

string <- c("hey ho, let's go!")
chr.gsub(c("hey", "ho"), c("ho", "hey"), string)

string <- "they don't understand the value of what they seek."
chr.gsub(c("the", "they"), c("a", "we"), string)

string <- c("hey ho, let's go!")
chr.gsub(c("hey", "ho"), "yo", string, recycle = TRUE)

string <- "Dopazamine is not the same as dopachloride or dopastriamine, yet is still fake."
chr.gsub(c("[Dd]opa([^ ]*?mine)","fake"), c("Meta\\1","real"), string)