Purpose:
Provide the user the capability to simply use JavaScript's built-in version of the replace function.

Parameters:

Returns:
The string with the specified target replaced.  If target is a string, the return value will have it replaced with replacement one time at most.  If target is a regular expression, the return value will have the target substring replaced as many times is specified by the regular expression flags.

Example #1:
The code below will show you how to search for one occurrence of a substring:

var message = "Where in the world is Carmen Sandiego?"; var encodedMsg = message.replace$(" ", " "); alert("The original message:\n" + message + "\n\nThe new message:\n" + encodedMsg);

Example #2:
The code below will show you how to use a regular expression to replace multiple instances of the space character with " ":

var message = "Where in the world is Carmen Sandiego?"; var encodedMsg = message.replace$(/ /g, " "); alert("The original message:\n" + message + "\n\nThe new message:\n" + encodedMsg);

See also:

• String.indicesOf(...)
• String.replace(...)