*********
replace()
*********

Purpose
=======

replace(str, substr_to_replace, replace_with)

Returns new string with all instances of substr_to_replace replaced
by replace_with.


Example
=======

.. code-block:: none

   replace("foo bar baz", " b", ", B")

produces

.. code-block:: none

   "foo, Bar, Baz"