Macro Reference — Editor Object — BatchFindInFiles Method (Editor Object)

# BatchFindInFiles Method (Editor Object)

Searches multiple files for multiple strings. The resultant list of the searched files will be displayed on the current window. If the document is not saved, this method will display the prompt message whether to save the file.

##

### [JavaScript]

    nFound = editor.BatchFindInFiles( filters, strPath, nFlags, [ nEncoding, [ strFilesToIgnore, [ nExFlags, [ nLimit ] ] ] ] );

### [VBScript]

    nFound = editor.BatchFindInFiles( filters, strPath, nFlags, [ nEncoding, [ strFilesToIgnore, [ nExFlags, [ nLimit ] ] ] ] )

## Parameters

filters

Specifies a Filters Collection which contains search strings and flags.

strPath

Specifies a path to search from. It can include wild cards such as * and ?.

nFlags

Specifies a combination of the following values.

eeFindOpenDirect | Directly opens the document that includes the specified string. Cannot combine with eeFindOpenFilter or eeFindOutput.
eeFindOpenFilter | Directly opens the document that includes the specified string, and set the specified string as the filter. Cannot combine with eeFindOpenDirect or eeFindOutput.
eeFindOutput | Displays the Find in Files results as a list in the Output Bar. Cannot combine with eeFindOpenDirect or eeFindOpenFilter.
eeFindRecursive | Searches in subfolders of the specified path.
eeFindReplaceIgnoreFiles | Ignores the files or folders specified by strFilesToIgnore.
eeOpenDetectAll | Detects all encodings.
eeOpenDetectCharset | Detects HTML/XML Charset.
eeOpenDetectUnicode | Detects Unicode signature (BOM).
eeOpenDetectUTF8 | Detects UTF-8.

Additionally, you may specify one of the following values.

eeFindFileAndMatched | File names and matched strings will be displayed.
eeFindFileLineAndMatched | File names, line numbers and matched strings will be displayed.
eeFindFileNamesOnly | Only file names will be displayed and the whole lines containing the searched string will not be displayed as results.
eeFindLineOnly | Only the whole lines containing the searched string will be displayed as results.
eeFindMatchedOnly | Only the matched strings will be displayed as results.

nEncoding

Selects from the Encoding Constants, or specify any code page used in the Windows Operating System. If 0 is specified or omitted, the encoding specified in the configuration properties associated with the searched file name will be used.

strFilesToIgnore

If nFlags includes eeFindReplaceIgnoreFiles, specify the file or folder names to ignore. It can include wild cards such as * and ?. To specify multiple files, use semicolons (;) to separate them.

nExFlags

Specifies a combination of the following values. However, only one of eeExFindRegexBoost, eeExFindRegexOnigmo, and eeExFindRegexOnigmoPerl can be specified. If none of them is specified, the default regular expression engine is used.

eeExFindCountFrequency | Creates a table of frequent strings from the Extract results. Must combine with eeFindLineOnly or eeFindMatchedOnly.
eeExFindMulti | Performs Bulk Find. If this is not specified, performs Batch Find.
eeExFindOutputEncoding | Appends encoding names to file names.
eeExFindRegexBoost | Uses Boost.Regex as the regular expression engine.
eeExFindRegexOnigmo | Uses Onigmo as the regular expression engine, using the Ruby syntax.
eeExFindRegexOnigmoPerl | Uses Onigmo as the regular expression engine, using the Perl syntax.

nLimit

EmEditor stops searching files when the number of matches reaches this number. If 0 is specified, EmEditor does not stop searching files.

## Return Values

The return value is the total number of lines containing matched strings in all the searched files.

## Version

Supported on EmEditor Professional Version 20.0 or later.