gsubs {jamba} | R Documentation |
Pattern replacement with multiple patterns
Description
Pattern replacement with multiple patterns
Usage
gsubs(
pattern,
replacement,
x,
ignore.case = TRUE,
replaceMultiple = rep(TRUE, length(pattern)),
...
)
Arguments
pattern |
|
replacement |
|
x |
|
ignore.case |
|
replaceMultiple |
|
... |
additional arguments are passed to |
Details
This function is a simple wrapper around base::gsub()
when considering a series of pattern-replacement
combinations. It applies each pattern match and replacement
in order and is therefore not vectorized.
When x
input is a list
each vector in the list
is processed,
somewhat differently than processing one vector.
When the
list
contains anotherlist
, or whenlength(x) < 100
, each value inx
is iterated callinggsubs()
. This process is the slowest option, however not noticeble untilx
has length over 10,000.When the
list
does not contain anotherlist
and all values are non-factor, or all values arefactor
, they are unlisted, processed as a vector, then relisted. This process is nearly the same speed as processing one single vector, except the time it takes to confirm the list element classes.When values contain a mix of non-factor and
factor
values, they are separately unlisted, processed bygsubs()
, then relisted and combined afterward. Again, this process is only slightly slower than option 2 above, given that it callsgsubs()
twice, with two vectors.Note that
factor
values at input are replaced withcharacter
values at output, consistent withgsub()
.
Value
character
vector when input x
is an atomic vector,
or list
when input x
is a list
.
See Also
Other jam string functions:
asSize()
,
breaksByVector()
,
fillBlanks()
,
formatInt()
,
gsubOrdered()
,
makeNames()
,
nameVector()
,
nameVectorN()
,
padInteger()
,
padString()
,
pasteByRow()
,
pasteByRowOrdered()
,
sizeAsNum()
,
tcount()
,
ucfirst()
Examples
gsubs(c("one", "two"), c("three", "four"), "one two five six")
gsubs(c("one", "two"), c("three"), "one two five six")