| Extracted from Pike v7.8 release 866 at 2016-04-05.

[Top]

# Method replace()

Method replace

  `string replace(string s, string from, string to)`
  `string replace(string s, array(string) from, array(string) to)`
  `string replace(string s, array(string) from, string to)`
  `string replace(string s, mapping(string:string) replacements)`
  `array replace(array a, mixed from, mixed to)`
  `mapping replace(mapping a, mixed from, mixed to)`

Description

  Generic replace function.

  This function can do several kinds replacement operations, the different syntaxes do different things as follows:

  If all the arguments are strings, a copy of s with every occurrence of from replaced with to will be returned. Special case: to will be inserted between every character in s if from is the empty string.

  If the first argument is a string, and the others array(string), a string with every occurrance of from [i] in s replaced with to [i] will be returned. Instead of the arrays from and to a mapping equvivalent to `<font face='courier'><a href='../predef_3A_3A/mkmapping.html'>mkmapping` (<font face='courier'>from , <font face='courier'>to ) can be used.

  If the first argument is an array or mapping, the values of a which are `==() with from will be replaced with to destructively. a will then be returned.

Note

  Note that replace() on arrays and mappings is a destructive operation.