ore.subst {ore} | R Documentation |
This function substitutes new text into strings in regions that match a regular expression. The substitutions may be simple text, may include references to matched subgroups, or may be created by an R function.
ore.subst(regex, replacement, text, ..., all = FALSE)
regex |
A single character string or object of class |
replacement |
A single character string, or a function to be applied to the matches. |
text |
A vector of strings to match against. |
... |
Further arguments to |
all |
If |
If replacement
is a function, then it will be passed as its first
argument an object of class "orearg"
. This is a character vector
containing as its elements the matched substrings, and with an attribute
containing the matches for parenthesised subgroups, if there are any. A
groups
method is available for this class, so the groups
attribute can be easily obtained that way. The substitution function will be
called once per element of text
.
A version of text
with the substitutions made.
# Simple text substitution (produces "no dogs") ore.subst("\\d+", "no", "2 dogs") # Back-referenced substitution (produces "22 dogs") ore.subst("(\\d+)", "\\1\\1", "2 dogs") # Function-based substitution (produces "4 dogs") ore.subst("\\d+", function(i) as.numeric(i)^2, "2 dogs")