<< 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

 

 

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

 

String Handling,

 

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