The ereplace() function searches a string expression for the search string and then, if at the start occurrence, replaces search.str with replacement.str for the amount of occurrences specified in occurrences.
Syntax
ereplace(str.exp, search.str, replacement.str {,occurrences {,start}}) |
Synonym(s)
change() swap() |
Parameter(s)
str.exp |
String in which the specified search.str is searched for. |
search.str |
String to search for in str.exp. |
replacement.str |
String to replace the specified search.str. |
occurrences |
Specifies the number of occurrences of search.str to be replaced by replacement.str. If not specified, defaults to 0, which replaces all found occurrences. |
start |
Specifies which occurrence of search string the replacement begins. If not specified, defaults to 1. |
Description
NOTE |
To use ereplace(), it is necessary to use a nondefault compiler compatibility option. Inserting the $options ext statement at the beginning of the program accomplishes this. |
Example(s)
Assigns the value "The old time" to nstring.
$options ext nstring = ereplace("The new time","new","old") |
This outputs "++-". The ereplace() function replaces one occurrence of "-" starting at the second occurrence.
print ereplace("---","-","+",2,1) |
See Also
Array References, Array Variable, Attribute Count Expression, del Statement, delete() Function, ereplace() Function, extract() Function, BASIC Functions, ins Statement, insert() Function, locate Statement, read Statement, replace Statement, replace() Function, Statements and Functions, Subvalue Count Expressions, swap() Function, Value Count Expression