Replace (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing strings

Replace

Presentation

Example

Replace function and UNICODE

See also

Replace (Function)

In french: Remplace

Replaces all the occurrences of a word found in a string by another word.

Note: The initial character string is not modified.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

Versions 15 and later

This function is now available for the Android applications.

New in version 15

This function is now available for the Android applications.

Versions 16 and later

This function is now available for the Windows Phone applications.

New in version 16

This function is now available for the Windows Phone applications.

Versions 17 and later

This function is now available for the iPhone/iPad applications.

New in version 17

This function is now available for the 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

See additional examples

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

Versions 18 and later

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

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

New in version 18

Versions 19 and later

InitialString is string = "Abracadabra!"
ReplacedString is string = Replace(InitialString, 4, 1, "o")
Trace(ReplacedString) // Displays "Abrocadabra!"

New in version 19

InitialString is string = "Abracadabra!"
ReplacedString is string = Replace(InitialString, 4, 1, "o")
Trace(ReplacedString) // Displays "Abrocadabra!"

Syntax

Replacing a string by another one Hide the details

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

<Result>: Character string

New character string in which the different replacements have been performed.

<Initial string>: Character string (with quotes)

Character string in which the replacements must be performed (maximum size: 2 GB).

<String to replace>: Character string (with quotes)

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

<New string>: Character string (with quotes)

Character 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 the whole word (enclosed in punctuation characters or in space characters)
IgnoreCase Searches while ignoring the case (lowercase/uppercase characters) and the accented characters.

The search is case sensitive by default: the sought string must have the same case as the string to find in the initial string. To perform a search while ignoring the case, 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 world: this string can be part of a word.

Versions 18 and later

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

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

<Result>: Character string

New character string in which the different replacements have been performed.

<Initial string>: Character string (with quotes)

Character string in which the replacements must be performed (maximum size: 2 GB).

<Array of strings to replace>: Array

Array of strings that must be replaced in <Initial String>. This array can correspond to:
an Array variable.
an array expressed 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 (with quotes)

Character 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 the whole word (enclosed in punctuation characters or in space characters)
IgnoreCase Searches while ignoring the case (lowercase/uppercase characters) and the accented characters.

The search is case sensitive by default: the sought string must have the same case as the string to find in the initial string. To perform a search while ignoring the case, use the IgnoreCase constant.

New in version 18

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

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

<Result>: Character string

New character string in which the different replacements have been performed.

<Initial string>: Character string (with quotes)

Character string in which the replacements must be performed (maximum size: 2 GB).

<Array of strings to replace>: Array

Array of strings that must be replaced in <Initial String>. This array can correspond to:
an Array variable.
an array expressed 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 (with quotes)

Character 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 the whole word (enclosed in punctuation characters or in space characters)
IgnoreCase Searches while ignoring the case (lowercase/uppercase characters) and the accented characters.

The search is case sensitive by default: the sought string must have the same case as the string to find in the initial string. To perform a search while ignoring the case, use the IgnoreCase constant.

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

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

<Result>: Character string

New character string in which the different replacements have been performed.

<Initial string>: Character string (with quotes)

Character string in which the replacements must be performed (maximum size: 2 GB).

<Array of strings to replace>: Array

Array of strings that must be replaced in <Initial String>. This array can correspond to:
an Array variable.
an array expressed 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 (with quotes)

Character 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 the whole word (enclosed in punctuation characters or in space characters)
IgnoreCase Searches while ignoring the case (lowercase/uppercase characters) and the accented characters.

The search is case sensitive by default: the sought string must have the same case as the string to find in the initial string. To perform a search while ignoring the case, use the IgnoreCase constant.

Versions 19 and later

Replacing a section of string by a new string Hide the details

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

<Result>: Character string

New character string into which the replacement was performed.

<Initial string>: Character string (with quotes)

Character string where the replacement will be performed (maximum size: 2 GB).

<Position>: Integer

Position of the section of string to replace.

<Length>: Integer

Length of the string section to replace.

<New string>: Character string (with quotes)

Character string that will replace the specified string section.

New in version 19

Replacing a section of string by a new string Hide the details

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

<Result>: Character string

New character string into which the replacement was performed.

<Initial string>: Character string (with quotes)

Character string where the replacement will be performed (maximum size: 2 GB).

<Position>: Integer

Position of the section of string to replace.

<Length>: Integer

Length of the string section to replace.

<New string>: Character string (with quotes)

Character string that will replace the specified string section.

Replacing a section of string by a new string Hide the details

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

<Result>: Character string

New character string into which the replacement was performed.

<Initial string>: Character string (with quotes)

Character string where the replacement will be performed (maximum size: 2 GB).

<Position>: Integer

Position of the section of string to replace.

<Length>: Integer

Length of the string section to replace.

<New string>: Character string (with quotes)

Character string that will replace the specified string section.

Remarks

Replace function 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):

It at least one of the strings is a buffer, all the strings are converted into buffers and the operation is performed with buffers,
otherwise, if at least one of the strings is in Unicode format, all the strings are converted into Unicode and the operation is performed in Unicode,
otherwise, the operation is performed in Ansi format.

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

It at least one of the strings is a buffer, all the strings are converted into buffers and the operation is performed with buffers,
otherwise, the operation is performed in Unicode.

Note: If the result on an ANSI string is assigned to a UNICODE string (and conversely), the conversion will be implicitly performed.

See Managing the UNICODE format for more details.

Component : wd240vm.dll