agrep - справочное руководство, опции, примеры команд


ИМЯ

agrep - печатать строки примерно совпадающие с шаблоном

СИНТАКСИС

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

ОПИСАНИЕ

Ищет приблизительные совпадения ШАБЛОНА в каждом ФАЙЛЕ или стандартном вводе. Пример:

agrep -2 optimize foo.txt

выводит все строки в файле `foo.txt', которые соответствуют "optimize" в пределах двух ошибок. Например. все строки, содержащие слова «оптимизировать», «оптимизировать» и «оптимизировать», совпадают.

ПАРАМЕТРЫ

Выбор и интерпретация регулярных выражений:

-e PATTERN, - -regexp=PATTERN

Используйте ШАБЛОН как регулярное выражение; полезно для защиты шаблонов, начинающихся с -.

-i, - -ignore-case

Игнорировать различия в регистре (как определено текущим языковым стандартом) в PATTERN и во входных файлах.

-k, - -literal

Рассматривайте PATTERN как литеральную строку, то есть фиксированную строку без специальных символов.

-w, - -word-regexp

Заставьте ШАБЛОН соответствовать только целым словам. «Целое слово» — это подстрока, которая либо начинается в начале записи, либо предшествует символу, не входящему в состав слова. Точно так же подстрока должна либо заканчиваться в конце записи, либо следовать символу, не входящему в состав слова. Символами, составляющими слово, являются буквенно-цифровые символы (в соответствии с текущим языковым стандартом) и символ подчеркивания. Обратите внимание, что символы, не входящие в состав слова, должны окружать совпадение; их нельзя считать ошибками.

Приблизительные совпадающие настройки:

-D NUM, - -delete-cost=NUM

Установите стоимость отсутствующих символов на ЧИСЛО.

-I NUM, - -insert-cost=NUM

Установите стоимость дополнительных символов на ЧИСЛО.

-S NUM, - -substitute-cost=NUM

Установите стоимость неправильных символов на ЧИСЛО. Обратите внимание, что удаление (отсутствующий символ) и вставка (дополнительный символ) вместе составляют замещающий символ, но стоимость будет равна сумме удаления и вставки. Таким образом, если константа замены задана больше, чем сумма затрат на удаление и вставку, прямая замена никогда не будет выполнена.

-E NUM, - -max-errors=NUM

Выберите записи, содержащие не более NUM ошибок.

-#

Выберите записи, содержащие не более # ошибок (# – цифра от 0 до 9).

Разнообразный:

-d PATTERN, - -delimiter=PATTERN

Установите для регулярного выражения разделителя записей значение ШАБЛОН. Текст между двумя разделителями, перед первым разделителем и после последнего разделителя считается записью. Разделителем записи по умолчанию является регулярное выражение "\n", поэтому запись по умолчанию представляет собой строку. ШАБЛОН может быть любым регулярным выражением, которое не соответствует пустой строке. Например, использование -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, используется -h, в противном случае по умолчанию используется -H.

ДИАГНОСТИКА

Статус выхода равен 0, если совпадение найдено, 1, если совпадение не найдено, и 2, если были ошибки. Если -E или -# не указан, выбираются только точные совпадения.

ШАБЛОН – это расширенное регулярное выражение POSIX (ERE) с расширениями TRE.

СООБЩЕНИЕ ОБ ОШИБКАХ

Сообщайте об ошибках в список рассылки TRE <tre-general@lists.laurikari.net>.

АВТОРСКИЕ ПРАВА

Copyright © 2002-2004 Вилле Лаурикари.
Это бесплатное программное обеспечение, и оно поставляется АБСОЛЮТНО НИКАКИХ ГАРАНТИЙ. Вы можете распространять это программное обеспечение при определенных условиях; полный текст лицензии см. в источнике.