Navigation:  thinBasic Modules > Core > String handling >

REPLACE$

Previous pageReturn to chapter overviewNext page

 

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, within sMainString, 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 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