ore (version 1.0.0)

ore.subst: Replace matched substrings with new text

Description

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.

Usage

ore.subst(regex, replacement, text, all = FALSE, ...)

Arguments

regex

A single character string or object of class "ore". In the former case, this will first be passed through ore.

replacement

A single character string, or a function to be applied to the matches.

text

A vector of strings to match against.

all

If TRUE, then all matches within each element of text will be found. Otherwise, the search will stop at the first match.

...

Further arguments to replacement, if it is a function.

Value

• A version of text with the substitutions made.

See Also

ore.search

Examples

# 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")