wide find - replace

• 纯 unicode 规则匹配内核，真正支持各国语言文字的正则匹配。
• 带有兼容性检查的字符集编码转换功能。同时支持 libiconv（iconv.dll） 、IBM libicu 和 Windows 自带的字符集编码转换 API。
• 支持 TCL 8.2 兼容的高级正则表达式（ARE）。
• 支持一次性指定多个文件通配符和文件列表。
• 支持管道模式，与其它命令协同工作；支持半管道模式，从文件中获取输入，但将结果写到标准输出。
• 支持包含子目录。
• 支持普通匹配、正则匹配、可忽略大小写、可跨行匹配。替换时可以使用正则的子表达式。
• 同时支持 posix 标准的扩展正则表达式及 perl 风格的正则匹配。
• 可以格式化替换内容为全大写或全小写，便于在批处理中对环境变量和命令行参数做大小写一致化处理。
• 支持 DOS（Windows）、Macintosh 和 unix 风格的换行符，可选择自动识别（默认）或手动指定。
• 统计功能，列出每个文件中的替换次数、总替换次数等。
• 支持 Win32 和纯 DOS 环境（纯DOS环境中需要 HX DOS Extender 支持）。
• 支持 POSIX 环境，提供 linux x86/x64、FreeBSD、NetBSD、Solaris 等版本下载。

2013-11-19, Ver 2.3.9-1119

2009-12-13, Ver 2.3.6.1213

2009-03-12, Ver 2.3.5.0312

2008-09-09, Ver 2.3.4.0909

2008-09-08, Ver 2.3.3.0908

2008-08-16, Ver 2.3.2.715

2007-01-20, Ver 2.3.1.120

• 小写类能够正确匹配各国小写字母。如：中文全角字母“ａｂｃｄ”；希腊字母“α、β、ω”；俄文字母“ж、я、щ” 等等。
• 大写类能够匹配各国大写字母。如：全角字母“ＡＢＣＤ”；希腊字母“Α、Β、Ω”；俄文字母“Ж、Я、Щ”等等。
• 字符类能匹配各国字母（中日韩的汉字也属于该类）。
• 标点类能够匹配各国标点符号，如：“、，。……『』”等等。
• 所有操作都支持宽字符，例如，表达式：“[我你他她它]们”将被正确处理。

1. 输入编码：输入文件或管道中内容的字符集编码。默认为当前系统的默认代码页。
2. 输出编码：完成搜索->替换操作后，要输出到目标文件或管道中的编码。默认与输入编码相同。
3. 参数编码：指定搜索和替换参数的内容使用何种字符集编码。默认为当前系统的默认代码页。

• 更严谨和稳定的结果：iconv 比 Windows 的字符集转换 API 更严格，不会出现意想不到的乱码和连篇问号等情况。
• 更有保障的支持：Windows 能否成功完成指定字符集编码转换，很大程度上取决于用户是否安装了相关的代码页文件。在任何部署了 libiconv 库的计算机中，该库支持的字符集编码都能够被正确地转换。
• 跨平台支持：libiconv 可以用于几乎所有已知的平台。

• 在命令行中单独使用，或作为管道过滤器使用。例如：“wfr *.txt *.htm -r:"张(\a+/>)" -t:"李\1"”将文档中所有姓张的兄弟姐妹改为姓李 :)
• 在批处理中应用。
• 与其它工具配合使用。

• 单纯的搜索替换。
• 单纯的字符集编码匹配和转换。
• 以上两种情况的混合应用。

C:\Documents and Settings\Administrator>
#wfr

≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
简单中文帮助

C:\Documents and Settings\Administrator>
#wfr

===============================================================================
   wide find and replace Ver 2.3.9-1119 by BaiYang / 2004 - 2013, 免费软件
                      主页地址 － http://baiy.cn
===============================================================================
在文件或管道中批量搜索-替换字符串——支持多字符集编码

用法: wfr [文件通配符1 文件通配符2 ...] {查找选项:查找内容} {替换选项:替换为} 
          [其它选项]

===============================================================================
查找选项:
  -f:      - 匹配精确串
  -fic:    - 匹配精确串（忽略大小写）
  -r:      - 正则表达式匹配
  -ric:    - 正则表达式匹配（忽略大小写）
  -rnnl:   - 跨行正则匹配
  -rnnlic: - 跨行正则匹配（忽略大小写）
  -any     - 匹配文件或管道中的所有内容，主要用于完成单纯的批量字符集编码转换

===============================================================================
替换选项:
  -t:      - 将匹配的内容替换为指定字符串
  -tu:     - 先将指定的“替换为”字符串变为大写，然后开始替换
  -tl:     - 先将指定的“替换为”字符串变为小写，然后开始替换
  注意: 如果您正在使用正则匹配，那么您可以在“替换为”字符串中使用子表达式代换 
        (\0 ～ \9)

===============================================================================
字符编码选项:
  -encin:  - 指定输入文本（文件或管道）的字符集编码。
               默认值: 使用当前操作系统的默认代码页。
  -encout: - 指定输出（结果）文本的字符集编码。
               默认值: 与 "-encin" 指定的值相同。
  -encarg: - 指定搜索和替换选项的内容使用何种字符集编码。
               默认值: 使用当前操作系统的默认代码页。
  -unisign - 如果输出指定为 UNICODE 宽字符编码 (如: UCS-2, UTF-8/16 等), 则在文
             件头部加入 BOM 签名，这样支持 unicode 的文本编辑器将会自动识别该文
             件的编码格式。
  -listenc - 列出所有 wfr 支持的字符集编码。
  -listcmp - 列出 wfr 认可的键入字符集编码转换规则表。
  -force   - 强制实施转换，忽略编码兼容性规则。

===============================================================================
其它选项:
  -h -?    - 当前屏幕
  -s       - 包含子目录
  -exp     - 启用内存扩展算法，将会加倍wfr 的内存使用量，但是很多时候可以极大地
             提高执行效率。现已默认开启。
  -noexp   - 禁用内存扩展算法，参考：-exp 选项的说明。
  -stdin   - 从标准输入设备获得要查找的内容，并将结果从到标准输出设备（如果未指
             定任何文件模板的话，则自动启用该选项）
  -stdout  - 像平时一样， 从文件中获得输入， 但将结果送到标准输出（而不是写回文
             件）
  -frc     - 显示每个文件内发生的替换次数
  -trc     - 显示所有文件总共发生的替换次数
  -errstop - 当遇到文件或子目录访问错误时，终止搜索任务。
             默认: 遇到无法访问的子目录访跳过；遇到无法访问的文件时，打印错误
             信息并继续

===============================================================================
POSIX 和 Perl 风格的正则表达式:

  - "find - replace" 完整支持 POSIX.2 扩展标准及 Perl 风格的正则表达式。
    以下是支持的字符类及其对应关系:
       POSIX           perl       描述
       --------------------------------------------------------------------
       [:alnum:]                  字母和数字
       [:alpha:]       \a         字母
       [:lower:]       \l         小写字母
       [:upper:]       \u         大写字母
       [:blank:]                  空格和制表符
       [:space:]       \s         空白字符
       [:cntrl:]                  控制字符
       [:digit:]       \d         十进制数字
       [:xdigit:]      \x         十六进制数字
       [:graph:]                  可打印字符（不包括空白符）
       [:print:]       \p         可打印字符（包括空白符）
       [:punct:]                  标点符号

  - 以下是一些 perl 的特殊字符类:
       perl   POSIX等效         描述
       --------------------------------------------------------------------
       \o     [0-7]             八进制数字
       \O     [^0-7]            非八进制数字
       \w     [[:alnum:]_]      单词组成
       \W     [^[:alnum:]_]     非单词组成
       \A     [^[:alpha:]]      非字母 
       \L     [^[:lower:]]      非小写字母
       \U     [^[:upper:]]      非大写字母
       \S     [^[:space:]]      非空白符
       \D     [^[:digit:]]      非十进制数字
       \X     [^[:xdigit:]]     非十六进制数字
       \P     [^[:print:]]      非可打印字符
       \<     [^[:alpha:]_]     单词开始
       \>     [^[:alnum:]_]     单词结束

  - 注意: posix 字符类是必须工作在集合中的（“[”和“]”内）。相反，perl 风格
          的字符类是工作在集合运算之外的。

  - 此外，为了便于在命令行输入一些特殊字符，特别定义了一下别名:
       perl风格      POSIX风格       描述
       -----------------------------------------------------------------------
       \"            [:dq:]          双引号
       \'            [:sq:]          单引号
       \t            [:tb:]          制表符
       \n            [:nl:]          换行符 (0x0A)
       \r            [:rt:]          回车符 (0x0D)
       \b            [:bs:]          退格符

===============================================================================
TCL 8.2 兼容的高级正则表达式（ARE）

  - 为 -r:, -ric:, -rnnl:, -rnnlic:  等命令添加 '***:' 前缀即可开启高级正则表达
    式功能。ARE 提供了比 POSIX ERE/BRE 更为强大的正则匹配语法，并且使用一套自定
    义的字符类。有关 ARE 的详细信息，请访问：
    http://baiy.cn/utils/_regex_doc/index.htm

===============================================================================
程序返回码:
  -1  - 执行替换时发生错误
   0  - 替换成功完成
   1  - 没有可替换的内容（未找到匹配的模板）

===============================================================================
开关的前缀和后缀:
  * 所有命令行开关（选项）都是大小写无关的（如: "-fic:" 和 "-FIC:"）
  * 开关的前缀可以是 "-" 或 "/"（如: "/s" 和 "-s"）
  * 开关的后缀可以是 ":" 或 "="（如: "/f:", "/f=", "-f:" 和 "-f=" 等效）

===============================================================================
应用示例:
  wfr *.txt *.htm -f:teh -t:the
  wfr *.txt -fic:"My Dir" -tu:"%ROOTDIR%"
  wfr *.cpp *.h -r:"***:(#define.*?)MY_DEF" /t:"HER_DEF"
  type server.log | wfr /r:"Connected.*218.79" /t:"**Attack** \0"
  type server.log | wfr /r:"^(Smith|James).*\n" /t
  unzip -l *.zip | wfr /r:"^(.{22}:\d\d\s*|(A|  \a| -|.*files$).*\n)" /t
  wfr *.txt /s /any /encin:gbk /encout:utf-8
  wfr *.log /any /encin:ucs-2 /encout:gbk /stdout | OtherApp.exe ...
  wfr *.txt *.htm -r:"张(\a+/>)" -t:"李\1"
  wfr *.txt *.htm -r:"[你我他她它]们" -t:"朋友们"

C:\Documents and Settings\Administrator>
#wfr

===============================================================================
    wide find and replace Ver 2.3.9-1119 by BaiYang / 2004 - 2013, Freeware
                          homepage - http://baiy.cn
===============================================================================
Find string in files or pipe, and replace it to another string With Multi-
charset encoding support.

USAGE: wfr [filePattern1 filePattern2 ...] {FindOption:StringToFind}
           {ReplaceOption:StringToReplacement} [OtherOptions]

===============================================================================
FIND OPTIONs:
  -f:      - find
  -fic:    - find ignore case
  -r:      - regular expresion find
  -ric:    - regular expresion find ignore case
  -rnnl:   - regular expresion find ignore newline
  -rnnlic: - regular expresion find ignore newline ignore case
  -any     - match anything in file, usually use to performing text encoding
             convertion

===============================================================================
REPLACE OPTIONs:
  -t:      - change the match to"StringToReplacement"
  -tu:     - make the "StringToReplacement" upper case, and change the match
             to it.
  -tl:     - make the "StringToReplacement" lower case, and change the match
             to it.
  NOTE: If find option you specified is a regular expresion method, the replace
        option will support sub expressions (\0-\9) as well.

===============================================================================
CHARSET ENCODING OPTIONs:
  -encin:  - specify charset encoding for the input text (file or pipe).
               DEFAULT: use current system's default codepage.
  -encout: - specify charset encoding for the output text.
               DEFAULT: same as "-encin".
  -encarg: - specify charset encoding of the find and replace options.
               DEFAULT: current system's default codepage.
  -unisign - if the output encoding is unicode (i.e. UCS-2, UTF-8/16, etc.),
             then add BOM signature to the file.
  -listenc - list all accepted charset encoding names.
  -listcmp - list all compatible encoding convertion combination.
  -force   - enforce the text encoding convertion specified by "-encin" and
             "-encout", even if it is not compatible.

===============================================================================
OTHER OPTIONs:
  -h -?    - Is screen
  -s       - include sub folders
  -exp     - enable the memory expand algorithm, will double the memory usage,
             but MUCH quick in many case. Now Default.
  -noexp   - disable the memory expansion algorithm. see also: -exp.
  -stdio   - get input from standard input device (keyboard and pipe),
             and put the results to standard output device.
             default when file pattern is omitted.
  -stdout  - get input from file(s) as normally, but put the results to
             standard output device.
  -frc     - show File Replacements Count
  -trc     - show Total Replacements Count
  -errstop - stop on a file or sub-directory access error (the old behave).
             DEFAULT: ignore the access error and try to continue.

===============================================================================
POSIX and perl style Regular Expression:

  - "find - replace" fully support POSIX.2 Extended and Perl style Regular
     Expresion. Here is a list of they character classes:
       POSIX           perl       Description
       --------------------------------------------------------------------
       [:alnum:]                  letters and digits
       [:alpha:]       \a         letters
       [:lower:]       \l         lowercase letters
       [:upper:]       \u         uppercase letters
       [:blank:]                  space and tab characters
       [:space:]       \s         whitespace characters
       [:cntrl:]                  control characters
       [:digit:]       \d         decimal digits
       [:xdigit:]      \x         hexadecimal digits
       [:graph:]                  printable characters excluding space
       [:print:]       \p         printable characters including space
       [:punct:]                  punctuation characters

  - And here a some special char classes in perl:
       perl   POSIX equivalent  Description
       --------------------------------------------------------------------
       \o     [0-7]             octal digit
       \O     [^0-7]            non-octal digit
       \w     [[:alnum:]_]      word character
       \W     [^[:alnum:]_]     non-word character
       \A     [^[:alpha:]]      non-alphabetic character
       \L     [^[:lower:]]      non-lowercase character
       \U     [^[:upper:]]      non-uppercase character
       \S     [^[:space:]]      non-whitespace character
       \D     [^[:digit:]]      non-digit
       \X     [^[:xdigit:]]     non-hex digit
       \P     [^[:print:]]      non-printable characters
       \<     [^[:alpha:]_]     begin of word
       \>     [^[:alnum:]_]     end of word

  - note: posix char class must working in the square brackets. contrary,
          perl's must stay outside of the brackets.

  - And several alias has been created to help input some special char:
       perl style    POSIX style     Description
       -----------------------------------------------------------------------
       \"            [:dq:]          double quotation
       \'            [:sq:]          single quotation
       \t            [:tb:]          table
       \n            [:nl:]          new line (0x0A)
       \r            [:rt:]          return (0x0D)
       \b            [:bs:]          backspace

    NOTE: the posix style alias also available on /t, /tu and /tl when using
          the regex ("/r" and "/ric") match.

===============================================================================
TCL 8.2 Compatibal ARE expression:

  - Use '***:' prefix with -r:, -ric:, -rnnl: or -rnnlic: to enable Advanced
    Regular Expression mode. The ARE mode have more powerful expression then
    POSIX BRE and ERE rule. And it has it's own char classes. More info at:
    http://baiy.cn/utils/_regex_doc/index.htm

===============================================================================
RETURN CODE:
  -1  - error occured when performing replacement.
   0  - replacement has been done successfully.
   1  - nothing to replace (pattern not found).

===============================================================================
SWITCH PREFIX and SUFFIX:
  * All switchs (options) are case-insensitive (i.e: "-fic:" or "-FIC:")
  * Switch Prefix can be either "-" or "/" (i.e: "/s" or "-s")
  * Switch Suffix can be either ":" or "=" (i.e: "/f:", "/f=", "-f:" or "-f=")

===============================================================================
EXAMPLEs:
  wfr *.txt *.htm -f:teh -t:the
  wfr *.txt -fic:"My Dir" -tu:"%ROOTDIR%"
  wfr *.cpp *.h -r:"***:(#define.*?)MY_DEF" /t:"\1HER_DEF"
  type server.log | wfr /r:"Connected.*218.79" /t:"**Attack** \0"
  type server.log | wfr /r:"^(Smith|James).*\n" /t
  unzip -l *.zip | wfr /r:"^(.{22}:\d\d\s*|(A|  \a| -|.*files$).*\n)" /t
  wfr *.txt /s /any /encin:gbk /encout:utf-8
  wfr *.log /any /encin:ucs-2 /encout:gbk /stdout | OtherApp.exe ...
  wfr *.txt *.htm -r:"

1. 下载 wfr_xxx_yyy.zip （其中 xxx 为操作系统，yyy 为硬件平台）。
2. 使用 upzip 命令解压：'unzip wfr_xxx_yyy.zip'。
3. 复制：'cp f /bin'

注意事项：

• 不同于 Windows/DOS 平台，由于 '/' 为 posix 路径分割符，所以开关前缀只能使用 '-'，例如：'-f:1234' 等。
• 由于 posix shell 自动展开文件通配符，这将导致匹配子目录功能不正常，所以应当使用单引号或双引号引用文件模板，例如：wfr '*.cpp' -r:"***:(#define.*?)MY_DEF" /t:"
  HER_DEF" 等。