REPLACE$
<< Click to Display Table of Contents >> Navigation: ThinBASIC Core Language > BuiltIn Functions > String functions > REPLACE$ |
Description
Within a specified string, replace all occurrences of one string with another string.
Syntax
s = REPLACE$(sMainString, [ANY] sMatchString, [WITH] sNewString)
Returns
String
Parameters
Name |
Type |
Optional |
Meaning |
Remarks
If you use the ANY option without using WITH option ...
•each occurrence of each character in sMatchString will be replaced with the corresponding character in sNewString.
•In this case, sMatchString and sNewString must be the same length, because there is a one-to-one correspondence between their characters.
•If sMatchString and sNewString will differ in size, no substitution will take place and sMainString string will be returned
If you use the ANY option in conjunction with WITH option
•each occurrence of each character in sMatchString will be replaced with sNewString within sMainString.
Restrictions
See also
Examples
Thanks to Abraxas for the following script example
Dim sMainString As String VALUE "HELLO WORLD"
Dim sMatchString As String VALUE "LO"
Dim sStringExpression As String VALUE "ThinBasic "
Dim sNewString As String VALUE "R"
Dim sREP As String
Dim sREM As String
Dim sRPL As String
Dim Count As DWORD VALUE 10
Dim sMsg As String
sREP = REPEAT$(Count, sStringExpression)
sREM = REMOVE$(sMainString,sMatchString)
sRPL = REPLACE$(sMainString, Any sMatchString, With sNewString)
sMsg += "sMainString = " & sMainString & $CRLF
sMsg += "sMatchString = " & sMatchString & $CRLF
sMsg += "sStringExpression = " & sStringExpression & $CRLF
sMSG += "Count = " & Count & $CRLF & $CRLF
sMsg += "REPEAT$(Count, StringExpression) = " & sREP & $CRLF & $CRLF
sMsg += "REMOVE$(sMainString,sMatchString) = " & sREM & $CRLF & $CRLF
sMsg += "REPLACE$(sMainString, [ANY] sMatchString, [WITH] sNewString) = " & sRPL & $CRLF & $CRLF
MSGBOX 0, sMsg