String.replace

Replaces the string find with the string replace in a #GString up to limit times. If the number of instances of find in the #GString is less than limit, all instances are replaced. If limit is 0, all instances of find are replaced.

If find is the empty string, since versions 2.69.1 and 2.68.4 the replacement will be inserted no more than once per possible position (beginning of string, end of string and between characters). This did not work correctly in earlier versions.

class String
uint
replace
(
string find
,
string replace
,
uint limit
)

Parameters

find string

the string to find in string

replace string

the string to insert in place of find

limit uint

the maximum instances of find to replace with replace, or 0 for no limit

Return Value

Type: uint

the number of find and replace operations performed.