ReplaceInFiles 方法 (Editor 对象)

在多个文件中替换文本。

[JavaScript]

nFound = editor.ReplaceInFiles( strFind, strReplace, strPath, nFlags, [ nEncoding, [ strFilesToIgnore, [ strBackupPath, [ nExFlags, [ nLimit ] ] ] ] ] );

[VBScript]

nFound = editor.ReplaceInFiles strFind, strReplace, strPath, nFlags, [ nEncoding, [ strFilesToIgnore, [ strBackupPath, [ nExFlags, [ nLimit ] ] ] ] ]

参数

strFind

指定一个要搜索的字符串。

strReplace

指定一个要替换为的字符串。

strPath

指定一个要搜索的路径。它包括通配符例如 \* 和 ?。

nFlags

指定一个下列值的组合。

eeFindRecursive	在指定路径的子文件夹中搜索。
eeFindReplaceCase	大小写需符合。
eeFindReplaceEscSeq	使用转义序列。不能与 eeFindReplaceRegExp 合用。
eeFindReplaceIgnoreFiles	忽略由 strFilesToIgnore 指定的文件或文件夹。
eeFindReplaceOnlyWord	匹配整个单词。
eeFindReplaceRegExp	使用正则表达式。不能与 eeFindReplaceEscSeq 合用。
eeFindSaveHistory	为重复搜索保存搜索过的字符串。
eeOpenDetectAll	检测所有编码。
eeOpenDetectCharset	检测 HTML/XML 字符集。
eeOpenDetectUnicode	检测 Unicode 签名 (BOM)。
eeOpenDetectUTF8	检测 UTF-8。
eeReplaceBackup	保存备份。不能与 eeReplaceKeepOpen 合用。
eeReplaceKeepOpen	保持已修改的文件开启。不能与 eeReplaceBackup 合用。

nEncoding

从 编码常数 中选择或指定任何用于 Windows 操作系统的代码页。

strFilesToIgnore

如果 nFlags 包括 eeFindReplaceIgnoreFiles，指定要忽略的文件或文件夹名称。它能包括通配符，例如 * 和 ?。要指定多个文件，用分号 (;) 来隔开文件。

strBackupPath

指定备份文件夹如果 nFlags 指定 eeReplaceBackup。

nExFlags

指定下列值的组合。但是，只能指定 eeExFindRegexBoost，eeExFindRegexOnigmo 和 eeExFindRegexOnigmoPerl 中的一个。如果不指定，则使用默认的正则表达式引擎。

eeExFindFuzzy	使用模糊匹配。
eeExFindNumberRange	匹配 数字范围表达式。此标志不能与 eeFindReplaceEscSeq 或 eeFindReplaceRegExp 合用。
eeExFindRegexBoost	使用 Boost.Regex 作为正则表达式引擎。
eeExFindRegexOnigmo	使用 Onigmo 作为正则表达式引擎，Ruby 语法。
eeExFindRegexOnigmoPerl	使用 Onigmo 作为正则表达式引擎，Perl 语法。

nLimit

当匹配数达到此数字时，EmEditor 停止搜索文件。 如果指定 0，则 EmEditor 不会停止搜索文件。

返回值

返回值是所有搜索的文件中已替换字符串的总数。

备注

这个动作不能被撤消除非 nFlags 指定 eeReplaceKeepOpen。建议您把 eeReplaceBackup 指定为 nFlags 并保存备份。如果相同的文件名称存在在备份文件夹中，那么新的备份会改写旧的文件。

版本

支持 EmEditor 4.02 或之后的版本。