agrep - 参考手册、选项、命令示例


姓名

agrep - 打印与模式大致匹配的行

概要

agrep [OPTION]... PATTERN [FILE]...

描述

在每个文件或标准输入中搜索 PATTERN 的近似匹配。例子:

agrep -2 optimize foo.txt

输出文件“foo.txt”中在两个错误内与“optimize”匹配的所有行。例如。包含“optimise”、“optmise”和“optimize”的行全部匹配。

选项

正则表达式选择和解释:

-e PATTERN, - -regexp=PATTERN

使用PATTERN作为正则表达式;对于保护以 - 开头的模式很有用。

-i, - -ignore-case

忽略 PATTERN 和输入文件中的大小写区别(由当前语言环境定义)。

-k, - -literal

将 PATTERN 视为文字字符串,即没有特殊字符的固定字符串。

-w, - -word-regexp

强制PATTERN仅匹配整个单词。 “整个单词”是从开头或记录开始或者前面有非单词组成字符的子字符串。类似地,子字符串必须在记录末尾结束,或者后跟非单词组成字符。单词组成字符是字母数字(由当前区域设置定义)和下划线字符。请注意,非单词组成字符必须包围匹配项;它们不能算作错误。

大致匹配设置:

-D NUM, - -delete-cost=NUM

将丢失字符的成本设置为 NUM。

-I NUM, - -insert-cost=NUM

将额外字符的成本设置为 NUM。

-S NUM, - -substitute-cost=NUM

将错误字符的成本设置为 NUM。注意,删除(丢失的字符)和插入(多余的字符)一起构成替换字符,但成本将是删除和插入加在一起的成本。因此,如果替换的 const 设置为大于删除和插入成本的总和,则永远不会进行直接替换。

-E NUM, - -max-errors=NUM

选择最多有 NUM 个错误的记录。

-#

选择最多有 # 个错误的记录(# 是 0 到 9 之间的数字)。

各种各样的:

-d PATTERN, - -delimiter=PATTERN

将记录分隔符正则表达式设置为PATTERN。两个分隔符之间、第一个分隔符之前和最后一个分隔符之后的文本被视为一条记录。默认的记录分隔符是正则表达式“\n”,因此默认情况下一条记录是一行。 PATTERN 可以是任何不匹配空字符串的正则表达式。例如,使用-d“^From”将邮件消息定义为邮箱格式文件中的记录。

-v, - -invert-match

选择不匹配的记录而不是匹配的记录。

-V, - -version

打印版本信息并退出。

-y, - -nothing

什么也没做。该选项的存在只是为了与非自由的 agrep 程序兼容。

- -help

显示简短的帮助消息并退出。

输出控制:

-B, - -best-match

只输出最佳匹配的记录,即成本最低的记录。目前,这是通过对输入文件进行两次传递来实现的,并且在从标准输入读取时无法使用。

- -color, - -colour

使用颜色标记突出显示输出中的匹配字符串。颜色字符串取自GREP_COLOR环境变量。默认颜色为红色。

-c, - -count

仅打印每个输入文件的匹配记录计数,从而抑制正常输出。

-h, - -no-filename

搜索多个文件时,在输出中禁止显示前缀文件名。

-H, - -with-filename

使用读取记录的输入文件的名称作为每个输出记录的前缀。

-l, - -files-with-matches

仅打印包含至少一个匹配项的每个输入文件的名称,从而抑制正常输出。每个文件的扫描将在第一个匹配时停止。

-n, - -record-number

在每个输出记录前面加上输入文件中的序列号。第一条记录的编号为 1。

-q, - -quiet, - -silent

不要向标准输出写入任何内容。如果找到匹配项,则立即退出,退出状态为零。

-s, - -show-cost

打印匹配成本与输出。

- -show-position

使用记录中第一个匹配项的开始和结束偏移量为每个输出记录添加前缀。记录的第一个字符的偏移量为 0。结束位置作为匹配后第一个字符的偏移量给出。

-M, - -delimiter-after

默认情况下,记录分隔符是换行符,在匹配的记录之后输出。如果使用-d,则记录分隔符将输出在匹配的记录之前。该选项导致分隔符在匹配记录之后输出。

没有 FILE 或当 FILE 为 - 时,读取标准输入。如果给定的FILE少于两个,则假定-h,否则-H为默认值。

诊断

如果找到匹配,则退出状态为 0;如果没有匹配,则退出状态为 1;如果存在错误,则退出状态为 2。如果未指定 -E 或 -#,则仅选择完全匹配。

PATTERN 是带有 TRE 扩展的 POSIX 扩展正则表达式 (ERE)。

报告错误

向 TRE 邮件列表<tre-general@lists.laurikari.net>报告错误。

版权

版权所有 © 2002-2004 Ville Laurikari。
这是免费软件,并且绝对不附带任何保证。欢迎您在一定条件下重新分发本软件;请参阅完整许可文本的来源。