====== ReplaceBetweenMany(text, string1, contents, string2 [,N]) ======
Category:  Text function

\\ 
=====Description=====
This function replaces in //text// the first //N// occurrences (or last //N// occurrences if a negative value is used) of any text between //string1// and //string2// with //contents//.

\\ 
=====Use cases=====
This function can be used for patching or editing HTML/XML data.

\\ 
=====Arguments=====
^Argument^Type^Description^
|text|Text (must //not// be empty)|The initial text value.|
|string1|Text (must //not// be empty)|The text string that defines the //starting point// of the text to be replaced.|
|string2|Text (must //not// be empty)|The text string that defines the //ending point// of the text to be replaced.|
|contents|Text (must //not// be empty)|The text string to be inserted between //string1// and //string2//, replacing any existing text.|
|N|Number (optional)|The first (or //last//, if negative) number of occurrences to replace.  If omitted, N defaults to 1.|

**Return value type:** Text

\\ 
=====Remarks=====
This function is case-sensitive.

//text//, //string1//, //string2// and //contents// are implicitly converted to text values if required.

If neither //string1// nor //string2// is not found within //text//, the original //text// string is returned.\\

\\ 
=====Examples=====
  replacebetweenmany('<a><b>', '<',  'c',  '>', 2) //Returns '<c><c>'

  replacebetweenmany('<a><b>', '<', 'c', ']' ) //Returns '<a><b>' ( ']' not found )

\\ 
===== See also =====
  * [[syntax:functions:regexreplace|RegExReplace(text, replace_text, regex_text)]]
  * [[syntax:functions:replace|Replace(text, string_old, string_new)]]
  * [[syntax:functions:replacebetween|ReplaceBetween(text, string1, contents, string2 [,N])]]