These functions provide convenient pattern finding and substitution for multiple patterns.
multiGSub(patterns, replacements, x, ...)
multiSub(patterns, replacements, x, ...)
multiGrep(patterns, x, ..., sort = TRUE, value = FALSE, invert = FALSE)
multiGrepl(patterns, x, ...)
multiSub
and multiGSub
return a character vector of the same length as x
, with all
patterns replaces by their replacements in each element of x
. multiSub
replaces each pattern in
each element of x
only once, multiGSub
as many times as the pattern is found.
multiGrep
returns the indices of those elements in x
in which at least one of patterns
was found, or, if invert
is TRUE, the indices of elements in which none of the patterns were found. If value
is TRUE, values rather than indices are returned.
multiGrepl
returns a logical vector of the same length as x
, with TRUE
is any of the
patterns matched the element of x
, and FALSE
otherwise.
A character vector of patterns.
A character vector of replacements; must be of the same length as patterns
.
Character vector of strings in which the pattern finding and replacements should be carried out.
Logical: should the output indices be sorted in increasing order?
Logical: should value rather than the index of the value be returned?
Logical: should the search be inverted and only indices of elements of x
matching none
of the patterns be returned?
Peter Langfelder
For each element of x
, patterns are sequentiall searched for and (for multiSub
and
multiGSub
substituted with the corresponding replacement.