| Extracted from Pike v7.8 release 866 at 2018-07-18.

[Top]
Regexp
Regexp.PCRE
Regexp.PCRE._Regexp_PCRE
Regexp.PCRE._Regexp_PCRE.Plain

# Method Regexp.PCRE._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"