strreplace—replace parts of a string
The strreplace function replaces parts of a string. The syntax for this function is as follows:
$NEWSTR=strreplace($ORGSTR,$SEARCH,$REPLACE)
strreplace($ORGSTR,$SEARCH,$REPLACE,$COUNT,$NEWSTR)
$NEWSTR=strreplace($ORGSTR,$SEARCH,$REPLACE,$COUNT)
strreplace($ORGSTR,$SEARCH,$REPLACE,$COUNT,$SKIP,$NEWSTR)
$NEWSTR=strreplace($ORGSTR,$SEARCH,$REPLACE,$COUNT,$SKIP)
strreplace arguments
Argument | Mode | Type | Description |
|---|---|---|---|
$ORGSTR | Input | STRING | The original string from which parts are to be replaced |
$SEARCH | Input | STRING | Specifies the part of the original string that you want to search for and replace |
$REPLACE | Input | STRING | Specifies the string that you want to replace the search string with |
$COUNT | Input | INTEGER | Specifies the maximum number of replacements |
$SKIP | Input | INTEGER | Specifies the number of $SEARCH strings to skip before replacement begins |
$NEWSTR | Output | STRING | The new string that is created as a result of the replacement |
Use the strreplace function to produce $NEWSTR from the original string ($ORGSTR) by replacing all occurrences of $SEARCH with $REPLACE. Replacement is performed from beginning of the string to the end and is not recursive.
If desired, you can limit the number of replacements to $COUNT. Replacements start at the beginning of the string until $COUNT number of replacements have occurred.
You can also specify a number of occurrences to skip ($SKIP) from the beginning of the string before starting replacements.
strreplace examples
The following example replaces all spaces with an underscore.
All spaces are replaced with underscores for the msg slot of the event that is represented by the variable $EV.
The following example replaces two occurrences of and with or.
The resulting string is $NEWSTR='or: o tempora o mandes'. The first two occurrences of and have been replaced with or.
The following example replaces two occurrences of and with or, skipping the first occurrence.
The resulting string is $NEWSTR='and: o tempora o mores'. The first occurrence of and is left as it is, and the following two occurrences of and have been replaced with or.