Macro Reference — Filters Collection — AddReplace Method (Filters Collection)

# 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.