batch wide find - replace

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

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

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

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

C:\Documents and Settings\Administrator>
#bwfr

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

用法: bwfr [文件通配符1 文件通配符2 ...] {查找选项:查找内容} {-argfile:替换规则
           文件} [其它选项]

===============================================================================
查找选项:
  -f:      - 匹配精确串
  -fic:    - 匹配精确串（忽略大小写）
  -r:      - 正则表达式匹配
  -ric:    - 正则表达式匹配（忽略大小写）
  -rnnl:   - 跨行正则匹配
  -rnnlic: - 跨行正则匹配（忽略大小写）

===============================================================================
参数文件选项:
您应当使用参数文件来指定 "查找/替换" 对。参数文件中的每一行代表一个查找替换对，
例如：
  1->a
  2->b
  3->c
  4->d
  ...
  -argfile:- 指定参数文件路径
  -dlm:    - 指定查找/替换对中，'查找' 部分和 '替换' 部分之间的分隔符。
             默认："->"
  注意: 如果您正在使用正则匹配，那么您可以在“替换”部分中中使用子表达式代换 
        (\0 ～ \9)
  注意：您可以在参数文件中使用系统环境变量，例如：
        Dir->%SystemRoot%
  注意：您可以使用 '\r' 和 '\n' 来表示 '回车符' 和 '换行符'，例如：
        1->a\r\n
        要输出 '\r' 和 '\n' 的字面值，可以使用 '\\r' 和 '\\n'。

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

===============================================================================
其它选项:
  -s       - 包含子目录
  -exp     - 启用内存扩展算法，将会加倍程序的内存使用量，但是很多时候可以极大地
             提高执行效率。现已默认开启。
  -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

  - 启用 ARE 的 argfile 示例：(mypat.txt)
      ***:(#define.*?)MY_API -> HER_API
      ***:myfunc(\(.*?\)) -> herfunc
      ...
      现在就可以使用 bwfr *.cpp -r -argfile:mypat.txt 命令完成 ARE 替换了

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

===============================================================================
应用示例:
  bwfr *.txt *.htm -fic -argfile:patterns.txt

C:\Documents and Settings\Administrator>
#bwfr

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

USAGE: bwfr [filePattern1 filePattern2 ...] {FindOption} {/argfile:<argfile>}
            [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

===============================================================================
ARGUMENTs FILE OPTIONs:
You should specify find/replace pairs by an arguments file with an one pair per
line semantic. for example:
  1->a
  2->b
  3->c
  4->d
  ...
  -argfile:- specify the arguments file path
  -dlm:    - specify the delimiter between 'find' part and 'replace' part in
             a find/replace pair. DEFAULT:"->"
  NOTE: If find option you specified is a regular expresion method, the replace
        part will support sub expressions (\0-\9) as well.
  NOTE: You can use environment variable in arguments file. for example:
        Dir->%SystemRoot%
  NOTE: You can use '\r' and '\n' to represent 'return' and 'newline'. for
        example:
        1->a\r\n
        To produce '\r' and '\n' literally, just type it as '\\r' and '\\n'.

===============================================================================
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 arguments file.
               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:
  -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

  - Argfile example for ARE: (mypat.txt)
      ***:(#define.*?)MY_API -> 
HER_API
      ***:myfunc(\(.*?\)) -> herfunc

      ...
    Now you can use 'bwfr *.cpp -r -argfile:mypat.txt' to perform ARE replace

===============================================================================
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:
  bwfr *.txt *.htm -f -argfile:patterns.txt

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

注意事项：

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