replace(String,String,String) -- replace substrings matching a regular expression

Synopsis

• Function: replace

• Usage:

  replace(re, replacement, str)

• Inputs:
  • re, a string, a regular expression describing a pattern
  • replacement, a string, following the formatting syntax
  • str, a string, a subject string to be processed
• Optional inputs:
  • POSIX => a Boolean value, default value false, if true, interpret the re using the POSIX Extended flavor, otherwise the Perl flavor
• Outputs:
  • a string, obtained from str by replacing its substrings matching re by copies of replacement

Description

i1 : replace("[a-z]+", "x", "Dog cat cat.")

o1 = Dx x x.

i2 : replace("(\\w+)\\.?", "A \\1.", "Dog cat cat.")

o2 = A Dog. A cat. A cat.

i3 : replace("(\\w+)\\.?", "A \\L$1.", "Dog cat cat.")

o3 = A dog. A cat. A cat.

i4 : s = "catfish cats dogs";

i5 : replace("cat(?!fish)s?", "\\U$&", s)

o5 = catfish CATS dogs

i6 : replace("\\w+(?=s\\b)", "\\U$&", s)

o6 = catfish CATs DOGs

i7 : s = "goldfish swordfish catfish catdog";

i8 : replace("\\w+(?=fish)", "\\U$&", s)

o8 = GOLDfish SWORDfish CATfish catdog

i9 : replace("(?<=cat)\\w+", "\\U$&", s)

o9 = goldfish swordfish catFISH catDOG

See also

• regular expressions -- syntax for regular expressions
• strings and nets -- an overview of strings and nets in Macaulay2
• regex -- evaluate a regular expression search
• match -- regular expression matching
• separate -- split a string into substrings using a regular expression
• select(String,String,String) -- select and reformat substrings matching a regular expression