AddReplace Method (Filters Collection)

Adds an item for a replace.

[JavaScript]

list.AddReplace( strFind, strReplace, nFlags, nExFlags );

[VBScript]

list.AddReplace( strFind, strReplace, nFlags, nExFlags )

Parameters

strFind

Specifies a string to search for.

strReplace

Specifies a string to replace with.

nFlags

Specifies a combination of the following values.

eeFindReplaceCase

Matches cases.

eeFindReplaceEscSeq

Uses escape sequences. Cannot be combined with eeFindReplaceRegExp.

eeFindReplaceOnlyWord

Matches only whole words.

eeFindReplaceRegExp

Uses a regular expression for the searched string. Cannot be combined with eeFindReplaceEscSeq.

nExFlags

Specifies a combination of the following values.

eeExFindLinkFile

Specifies strFind is the file path to a linked file that contains multiple search strings divided by newlines. If a tab character is included in a line, the search string is the first string not including the tab character, and the replace string is the second string. strFind may be a relative path from the EmEditor install path. It may contain environment variables such as %USERPROFILE%. To specify a file in the running macro folder, use this form:
ScriptFullName.substr( 0, ScriptFullName.lastIndexOf( "\\" ) + 1 ) + "LinkFile.txt"

eeExFindNumberRange

Matches a number range expression. This flag cannot be combined with eeFindReplaceEscSeq or eeFindReplaceRegExp.

eeExFindFuzzy

Uses fuzzy matching.

Version

Supported on EmEditor Professional Version 19.9 or later.