Method Regexp.PCRE.Plain()->replace_positional()

Method replace_positional

string replace_positional(string subject, string subst)

Description

replaces matches in a string, with support for backreferences (matched groups)

Parameter subject

the string to be tested against the regular expression

Parameter subst

string to be inserted in place of each match. backreferences can be inserted into the string to be substituted using the syntax %[n]s where n is the nth matching string group, and 0 (zero) is the full match.

example:

> Regexp.PCRE.Plain("my name is ([a-zA-Z]+)")
      ->replace_positional("allow me to introduce myself: my name is john", 
                          "%[0]s is my name");
  (1) Result: "allow me to introduce myself: john is my name"