<String type>.Replace (Function)

Replaces all occurrences of a specified substring in a string with another specified substring.

Remark: The initial character string is not modified.

Versions 18 and later

This function is now available in Android widget mode.

New in version 18

This function is now available in Android widget mode.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 21 and later

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

Example

InitialString is string = "Abracadabra!"
ReplacedString is string = InitialString.Replace("a", "o")
Info(ReplacedString) // Displays "Abrococobro!"

Versions 18 and later

InitialString is string = "beetroot // apricot // strawberry / melon \ nuts / lemon"
ReplacedString is string = InitialString.Replace(["//", "/", "\", "\\"], "-")
Trace(ReplacedString) // Displays "beetroot - apricot - strawberry - melon - nuts - lemon"

arrMyArray is array of 4 strings
arrMyArray[1] = "//"
arrMyArray[2] = "/"
arrMyArray[3] ="\"
arrMyArray[4] = "\\"
RemplacedString = InitialString.Replace(arrMyArray, "-")
Trace(ReplacedString) // Displays "beetroot - apricot - strawberry - melon - nuts - lemon"

New in version 18

InitialString is string = "beetroot // apricot // strawberry / melon \ nuts / lemon"
ReplacedString is string = InitialString.Replace(["//", "/", "\", "\\"], "-")
Trace(ReplacedString) // Displays "beetroot - apricot - strawberry - melon - nuts - lemon"

arrMyArray is array of 4 strings
arrMyArray[1] = "//"
arrMyArray[2] = "/"
arrMyArray[3] ="\"
arrMyArray[4] = "\\"
RemplacedString = InitialString.Replace(arrMyArray, "-")
Trace(ReplacedString) // Displays "beetroot - apricot - strawberry - melon - nuts - lemon"

Versions 18 and later

InitialString is string = "beetroot // apricot // strawberry / melon \ nuts / lemon"
ReplacedString is string = InitialString.Replace(["//", "/", "\", "\\"], "-")
Trace(ReplacedString) // Displays "beetroot - apricot - strawberry - melon - nuts - lemon"

arrMyArray is array of 4 strings
arrMyArray[1] = "//"
arrMyArray[2] = "/"
arrMyArray[3] ="\"
arrMyArray[4] = "\\"
RemplacedString = InitialString.Replace(arrMyArray, "-")
Trace(ReplacedString) // Displays "beetroot - apricot - strawberry - melon - nuts - lemon"

New in version 18

InitialString is string = "beetroot // apricot // strawberry / melon \ nuts / lemon"
ReplacedString is string = InitialString.Replace(["//", "/", "\", "\\"], "-")
Trace(ReplacedString) // Displays "beetroot - apricot - strawberry - melon - nuts - lemon"

arrMyArray is array of 4 strings
arrMyArray[1] = "//"
arrMyArray[2] = "/"
arrMyArray[3] ="\"
arrMyArray[4] = "\\"
RemplacedString = InitialString.Replace(arrMyArray, "-")
Trace(ReplacedString) // Displays "beetroot - apricot - strawberry - melon - nuts - lemon"

Syntax

Replacing a string with another string Hide the details

<Result> = <Initial string>.Replace(<String to replace> , <New string> [, <Option>])

<Result>: Character string

New string in which the specified strings have been replaced.

<Initial string>: Character string

String in which the specified strings will be replaced (maximum size: 2 GB).

<String to replace>: Character string

String to be replaced in the initial string.
If this parameter corresponds to an empty string (""), <Result> will correspond to <Initial string>.

<New string>: Character string

String that will replace <String to replace>.
If this parameter corresponds to an empty string (""), all the occurrences of <String to replace> will be deleted.

<Option>: Optional constant (or combination of constants)

Indicates the characteristics of the search for the word to replace:
WholeWord Searches for a whole word (between punctuation characters or spaces)
IgnoreCase Case and accent insensitive search (ignores uppercase and lowercase differences).

By default, the search is case-sensitive: the search string must have the same case as the string to find in the initial string. To perform a case-insensitive search, use the IgnoreCase constant.
This parameter is not available. The search is case sensitive. The string to replace does not necessarily correspond to a whole word: this string can be part of a word.

Replacing a set of strings with a new string Hide the details

<Result> = <Initial string>.Replace(<Array of strings to replace> , <New string> [, <Option>])

<Result>: Character string

New string in which the specified strings have been replaced.

<Initial string>: Character string

String in which the specified strings will be replaced (maximum size: 2 GB).

<Array of strings to replace>: Array

Array of strings to be replaced in <Initial string>. This array can correspond to:
an Array variable.
an array in the following format: [Value1, Value2, ... , Value N].
If this parameter corresponds to an empty string (""), <Result> will correspond to <Initial string>.

<New string>: Character string

String that will replace all the strings specified in <Array of strings to replace>.
If this parameter corresponds to an empty string (""), all the occurrences of <String to replace> will be deleted.

<Option>: Optional constant (or combination of constants)

Indicates the characteristics of the search for the words to replace:
WholeWord Searches for a whole word (between punctuation characters or spaces)
IgnoreCase Case and accent insensitive search (ignores uppercase and lowercase differences).

By default, the search is case-sensitive: the search string must have the same case as the string to find in the initial string. To perform a case-insensitive search, use the IgnoreCase constant.

Replacing part of string with a new string Hide the details

<Result> = <Initial string>.Replace(<Position> , <Length> , <New string>)

<Result>: Character string

New string in which the specified part of string has been replaced.

<Initial string>: Character string

String in which the specified part of string will be replaced (maximum size: 2 GB).

<Position>: Integer

Position of the part of string to replace.

<Length>: Integer

Length of the part of string to replace.

<New string>: Character string

String that will replace the specified part of string.

Remarks

<String type>.Replace and UNICODE

<Initial string>, <String to replace> and <New string> can correspond to:

ANSI strings.
UNICODE strings.
buffers.

You have the ability to use ANSI strings, Unicode strings and buffers in the different parameters of the function.

The following conversion rule is used for the Ansi systems (Windows or Linux):

If at least one of the strings is a buffer, all the strings are converted to buffers and the operation is performed with buffers.
If the first condition is not met and there is at least one Unicode string, all the strings are converted to Unicode and the operation is performed in Unicode (the conversion is performed with the current character set, if necessary).
Otherwise, the operation is performed in Ansi.

The following conversion rule is used for the Unicode systems (Windows CE):

If at least one of the strings is a buffer, all the strings are converted to buffers and the operation is performed with buffers.
Otherwise, the operation is performed in Unicode.

For more details on UNICODE, see Managing UNICODE.

Reminder: The linguistic parameters used are defined during the call to ChangeCharset.

Component: wd270vm.dll