String.replace

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

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.

Parameters

findthe string to find in string
replacethe string to insert in place of find
limitthe maximum instances of find to replace with replace, or 0 for no limit

Returns

the number of find and replace operations performed.