Загальна інформація про програму¶

--help

Виводить повідомлення щодо користування програмою та закривається.

-V, --version

Виводить номер версії grep.

Відбір збігу¶

-E, --extended-regexp

Інтерпретуе ЗРАЗОК як розширений регулярний вираз (ERE, див. нижче).

-F, --fixed-strings

Інтерпретує ЗРАЗОК як список фіксованих рядків (замість регулярних виразів), розділених новими рядками, будь-який з яких має бути зіставлений.

-G, --basic-regexp

Інтерпретує ЗРАЗОК як базовий регулярний вираз (BRE, див. нижче). Це типове значення.

-P, --perl-regexp

Інтерпретує зразок як Perl-сумісний регулярний вираз (PCRE). Це експериментальна можливість, опція grep -P може попереджати про нереалізовані функції.

Контроль відповідності¶

-e ЗРАЗОК, --regexp=ЗРАЗОК

Використовує ЗРАЗОК як шаблон. Якщо цей параметр використовується кілька разів або поєднується з параметром -f (--file), знаходить усі задані зразки. Цей параметр можна використовувати для захисту шаблону, який починається з “-”.

-f ФАЙЛ, --file=ФАЙЛ

Отримує зразки з ФАЙЛ, по одному на рядок. Якщо цей параметр використовується кілька разів або поєднується з параметром -e (--regexp), знаходить усі задані зразки. Порожній файл не містить зразків, тому нічого не виводить.

-i, --ignore-case

Ігнорує розбіжності регістру, тож символи, які відрізняються лише регістром, відповідають один одному.

-v, --invert-match

Параметр відповідності обертається, щоб вибирати невідповідні зразку рядки.

-w, --word-regexp

Вибираються лише ті рядки, що містять збіги, які утворюють цілі слова. Перевірка полягає в тому, що підрядок, який збігається, може знаходитися на початку рядка, або передувати символу, який не входить до складу слова. Так само він може бути в кінці рядка, або за ним може слідувати символ, який не входить до складу слова. Символами, що входять до складу слова, є літери, цифри та символ підкреслення. Цей параметр не діє, якщо також вказано -x.

-x, --line-regexp

Вибираються лише повністю відповідні зразку строки. Для зразка регулярного виразу це все одно, що помістити шаблон у круглі дужки, а потім оточити його ^ і $.

-y

Застарілий синонім до -i.

Загальне керування виведенням¶

-c, --count

Пригнічує звичайний вивід; замість цього виводить кількість відповідних рядків для кожного файлу вводу. За допомогою параметра -v, --invert-match (див. нижче), виводить число рядків, які не збігаються.

--color[=КОЛИ], --colour[=КОЛИ]

Оточує відповідні (непорожні) рядки, відповідні рядки, контекстні рядки, імена файлів, номери рядків, зміщення байтів і роздільники (для полів і груп контекстних рядків) escape-послідовністю, щоб відобразити їх у кольорі в терміналі. Кольори визначаються змінною середовища GREP_COLORS. Застаріла змінна середовища GREP_COLOR все ще підтримується, але її налаштування не мають пріоритету. КОЛИ – це ніколи, завжди або auto.

-L, --files-without-match

Пригнічує нормальний вивід; замість цього виводить ім'я кожного файлу, з якого зазвичай не було б виведено жодного результату. Сканування зупиниться на першому збігу.

-l, --files-with-matches

Пригнічує нормальний вивід; натомість виводить ім'я кожного вхідного файлу, з якого зазвичай було б виведено вихідні дані. Сканування зупиниться на першому збігу.

-mЧИСЛО, --max-count=ЧИСЛО

Пошук у файлі припиняється після вказаного ЧИСЛА рядків, які збіглися. Якщо ввід відбувається зі звичайного файлу, grep зупинить пошук одразу ж на наступному рядку після останнього рядка, який збігається і припинить роботу. Це дозволяє поновити процес пошуку з місця зупинки. Коли grep зупиняється після вказаного ЧИСЛА відповідних рядків, він виводить будь-який наступний рядок. Якщо додатково використовується параметр -c або --count, grep не виводить кількість більшу, ніж ЧИСЛО. Коли додатково вживається параметр -v або --invert-match, grep зупиняється після виведення ЧИСЛА невідповідних рядків.

-o, --only-matching

Виводить лише узгоджені (непорожні) частини відповідного рядка, причому кожний збіг виводиться в окремий рядок.

-q, --quiet, --silent

Мовчазний вивід; не виводить нічого в звичайному випадку. Негайно припиняє роботу із нульовим статусом, якщо знайдено будь-який збіг, навіть якщо була виявлена помилка. Також дивіться параметр -s або --no-messages.

-s, --no-messages

Пригнічуються повідомлення про помилки щодо неіснуючих або недоступних файлів.

Управління Префіксом Вихідного Рядка¶

-b, --byte-offset

Ставить перед кожним рядком номер блоку, в якому він був знайдений, починаючи з 0. Якщо додатково вказати -o (--only-matching), виводить номер блоку найбільш відповідної частини.

-H, --with-filename

Виводить назву файлу для кожного збігу. Це типове значення, якщо для пошуку потрібно більше одного файлу.

-h, --no-filename

Пригнічує показ імен файлів у виводі. Це типове значення, якщо пошук проводиться лише в одному файлі (або стандартний ввід).

--label=НАЗВА

Відображає вхідні дані, які фактично надходять зі стандартного введення, як вхідні дані, що надходять із файлу ЯРЛИК. Це особливо корисно під час реалізації таких інструментів, як zgrep, наприклад, gzip -cd foo.gz | grep --label=foo -H щось. Дивіться також параметр -H.

-n, --line-number

Виводить перед кожним рядком його номер у файлі (нумерація починається з 1).

-T, --initial-tab

Перевіряє, що перший символ фактичного вмісту рядка лежить на табуляції, щоб вирівнювання табуляторів виглядало нормально. Це корисно робити разом з параметрами, які передбачають вивід до фактичного вмісту: -H, -n і -b. Щоб підвищити ймовірність того, що всі рядки з одного файлу будуть починатися з одного стовпця, також друкується номер рядка та зміщення блоків (якщо воно є) у мінімальній ширині розміру поля.

-u, --unix-byte-offsets

Зміщення байтів у стилі Unix. Цей ключ змушує grep повідомляти про зміщення байтів, як якщо б файл був текстовим файлом у стилі Unix, тобто з вилученими символами CR. Це дасть результати, ідентичні запуску grep на машині Unix. Ця опція не діє, якщо також не використовується параметр -b; він не впливає на інші платформи, крім MS-DOS та MS-Windows.

-Z, --null

Виведіть нульовий байт (символ ASCII NUL) замість символу, який зазвичай слідує після імені файлу. Наприклад, grep -lZ виводить нульовий байт після кожного імені файлу замість звичайного нового рядка. Ця опція забезпечує однозначний вивід, навіть у випадку назв файлів що містять незвичні знаки, такі як знак нового рядка. Ця опція може використовуватись разом з такими командами як find -print0, perl -0, sort -z та xargs -0 для обробки довільних назв файлів.

Контроль контексту рядка¶

-AЧИСЛО, --after-context=ЧИСЛО

Виводить ЧИСЛО рядків кінцевого контексту після відповідних рядків. Розміщує рядок із роздільником груп (--) між безперервними групами збігів. З опцією -o або --only-matching команда, про що виводиться попередження.

-BЧИСЛО, --before-context=ЧИСЛО

Виводить ЧИСЛО рядків початкового контексту перед відповідними рядками. Розміщує рядок із роздільником груп (--) між безперервними групами збігів. З опцією -o або --only-matching команда не працює, про що виводиться попередження.

-CЧИСЛО, -ЧИСЛО, --context=ЧИСЛО

Виводить ЧИСЛО рядків вихідного контексту. Розміщує рядок із роздільником груп (--) між безперервними групами збігів. З опцією -o або --only-matching команда не працює, про що виводиться попередження.

Вибір файлів і каталогів¶

-a, --text

Двійковий файл обробляється так, ніби це текст; це еквівалентно параметру --binary-files=text.

--binary-files=ТИП

Якщо дані або метадані файлу вказують, що цей файл містить двійкові дані, припускається що файл має тип ТИП. Нетекстові байти вказують на двійкові дані; це або вихідні байти, які неправильно закодовані для поточної локалі, або нульові вхідні байти, якщо параметр -z не заданий.

Типово ТИП є binary, і коли grep виявляє, що файл є двійковим, він пригнічує будь-який подальший вивід, а замість цього виводить однорядкове повідомлення про те, що файл є двійковий, або немає повідомлення якщо відповідності немає.

Якщо ТИП є without-match, коли grep визначає, що файл є двійковим, він припускає, що решта файлу не збігається (із зразком); це еквівалентно параметру -I.

Якщо ТИП є text, grep обробляє двійковий файл так, ніби це текст; це еквівалентно параметру -a.

Коли тип є binary, grep може розглядати нетекстові блоки як команди терміналу навіть без параметра -z. Це означає, що вибір binary замість text може вплинути на те, чи відповідає шаблон файлу. Наприклад, коли тип є binary, зразок q$ might відповідатиме q, за яким одразу слідує нульовий байт, навіть якщо він не збігається, коли тип є text.

Попередження: Опція -a може виводити двійкове сміття, що може мати неприємні побічні ефекти, якщо результат виводиться у термінал і движок терміналу інтерпретує це як команди. З іншого боку, під час читання файлів, кодування тексту яких невідомі, може бути корисним використовувати -a або встановити у середовищі LC_ALL='C', щоб знайти більше збігів, навіть якщо збіги небезпечні для прямого показу.

-D ДІЯ, --devices=ДІЯ

Якщо вхідний файл є пристроєм, FIFO або сокетом, використовуйте ДІЯ для обробки вводу. Типово, ДІЯ має значення read, це означає, що пристрої читаються так само, ніби звичайні файли. Якщо ДІЯ має значення skip, пристрої ігноруються.

-d ДІЯ, --directories=ДІЯ

Якщо вхідний файл є каталогом, використовуйте для його обробки ДІЯ. Типовим значенням ДІЯ є read, тобто читати каталоги так, як якщо б вони були звичайними файлами. Якщо ДІЯ є skip, каталоги пропускаються "мовчки". Якщо ДІЯ є recurse, всі файли в кожному каталозі читаються рекурсивно, з переходом за символічними посиланнями, лише якщо вони знаходяться в командному рядку. Це подібно параметру -r.

--exclude=ШАБЛОН ПОШУКУ

Пропускає будь-який файл командного рядка із суфіксом імені, який відповідає зразку ШАБЛОН ПОШУКУ, використовуючи підстановку; суфікс імені – це або ціла назва, або будь-який суфікс, що починається після / і перед +не-/. Під час рекурсивного пошуку пропускається будь-який підфайл, базова назва якого відповідає ШАБЛОН ПОШУКУ; базова назва — частина після останнього /. Зразок може використовувати *, ? і [...] як символи підстановки, а \ для буквального цитування символу підстановки або зворотної косої риски.

--exclude-from=ФАЙЛ

Пропускаються файли, базова назва яких збігається з будь-яким із назв файлів, зчитаних з ФАЙЛ (з використанням зіставлення підстановки, як описано в розділі --exclude).

--exclude-dir=ШАБЛОН ПОШУКУ

Пропускається будь-який каталог командного рядка із суфіксом імені, який відповідає шаблону ШАБЛОН ПОШУКУ. Під час рекурсивного пошуку пропускається будь-який підкаталог, базова назва якого відповідає ШАБЛОН ПОШУКУ. Будь-які зайві кінцеві косі риски в ШАБЛОН ПОШУКУ ігноруються.

-I

Двійковий файл обробляється так, ніби він не містить відповідних даних; це еквівалентно параметру --binary-files=without-match.

--include=ШАБЛОН ПОШУКУ

Шукайте лише файли, базова назва яких відповідає ШАБЛОН ПОШУКУ (використовуючи підстановку, як описано в розділі --exclude).

-r, --recursive

Всі файли в кожному каталозі читаються рекурсивно, з переходами за символічними посиланнями, лише якщо вони знаходяться в командному рядку. Зверніть увагу, що якщо не вказано операнд файлу, grep шукає лише робочому каталозі. Це еквівалентно параметру -d recurse.

-R, --dereference-recursive

Рекурсивно читаються всі файли в кожному каталозі. Перехід за всіма символічними посиланнями робиться, на відміну від -r.

Інші параметри¶

--line-buffered

Використовується буферизація рядків на виводі. Це може призвести до зниження продуктивності.

-U, --binary

Файл(и) розглядається як двійковий. Типово, у системах MS-DOS та MS-Windows, grep вгадує, чи є файл текстовим чи двійковим, за описом у параметрі --binary-files. Якщо grep вирішить, що файл є текстовим, він видаляє CR знаки з оригінального файлу (щоб регулярні вирази з ^ і $ працювали правильно). Вказання -U скасовує вгадування, зумовлюючи прочитання всіх файлів і буквальну передачу їх механізму порівнювання; якщо це був текстовий із CR/LF парою наприкінці кожного рядка, це може призвести до розбіжності з деякими зразками. Цей параметр не впливає на інші платформи, крім MS-DOS і MS-Windows.

-z, --null-data

Ввідні та вихідні дані розглядаються як послідовності рядків, кожен з яких закінчується нульовим байтом (символом ASCII NUL) замість знака нового рядка. Так само як -Z або --null, цю опцію можна використовувати з такими командами, як sort -z для обробки довільних назв файлів.

Класи Символів та Вирази в Дужках¶

вираз у дужках — це список символів, укладених [ і ]. Він відповідає будь-якому окремому символу в цьому списку; якщо першим символом списку є каретка ^, то він відповідає будь-якому символу ні у списку. Наприклад, регулярний вираз [0123456789] відповідає будь-якій одній цифрі.

Вираз в дужках діапазон виразу складається з двох символів, розділених дефісом. Він відповідає будь-якому окремому символу, який знаходиться між двома символами включно із цими символами, використовуючи послідовності відносно до локалі та набору символів. Наприклад, у стандартній локалі C, типово, [a-d] еквівалентно [abcd]. Є багато мовних локалей, які сортують символи в порядку словника, і в цих мовах [a-d] зазвичай не еквівалентне [abcd]; це може бути еквівалентним, наприклад, [aBbCcDd]. Щоб отримати традиційну інтерпретацію виразів у квадратних дужках, можна використовувати локаль C, встановивши для змінної середовища LC_ALL значення C.

Нарешті, певні іменовані класи символів попередньо визначені у виразах у дужках, як показано нижче. Їхні назви зрозумілі самі за собою: [:alnum:], [:alpha:], [:cntrl:], [:digit:], [:graph :], [:lower:], [:print:], [:punct:], [:space:], [:upper:] і [:xdigit:].. Наприклад, [[:alnum:]] означає клас символів цифр і літер у поточній мовній локалі. У кодуванні локалі C і набору символів ASCII це те саме, що [0-9A-Za-z]. (Зауважте, що дужки в назвах класів є частиною символічних імен і повинні бути включені на додаток до дужок, що розмежовують вираз у дужках.) Більшість спеціальних символів втрачають своє особливе значення всередині виразів у дужках. Щоб включити символ ], розмістіть його першим у списку. Аналогічно, щоб включити символ ^, розмістіть його де завгодно, але спочатку. Нарешті, щоб включити символ -, поставте його останнім.

Прив'язування¶

Каретка ^ та знак долара $ є спеціальними символами, які позначають у порожньому рядку початок і кінець рядка відповідно.

Символ Зворотнього Слешу та Спеціальні Вирази¶

Символи \< і \> відповідно відповідають порожньому рядку на початку і в кінці слова. Символ \b відповідає порожньому рядку на краю слова, а \B відповідає порожньому рядку за умови, що це НЕ на краю слова. Символ \w є синонімом [_[:alnum:]], а \W є синонімом [^_[:alnum:]].

Повторення¶

За регулярним виразом може слідувати один з кількох операторів повторення:

?

Попередній елемент є необов'язковим і збігається не більше одного разу.

*

Попередній елемент буде збігатися нуль або більше разів.

+

Попередній елемент буде збігатися один або кілька разів.

{n}

Попередній елемент збігається точно n разів.

{n,}

Попередній елемент збігається n або більше разів.

{,m}

Попередній елемент збігається не більше m разів. Це розширення GNU.

{n,m}

Попередній елемент збігається щонайменше n разів, але не більше m разів.

Ланцюжок¶

Два регулярних вирази можуть бути об'єднані; отриманий регулярний вираз відповідає будь-якому рядку, утвореному шляхом зчеплення двох підрядків, які відповідно збігаються об'єднаним виразам.

Черговість¶

Два регулярні вирази можуть бути об'єднані за допомогою оператора |; отриманий регулярний вираз відповідає будь-якому рядку, що відповідає будь-якому альтернативному виразу.

Пріоритетність¶

Повторення має перевагу над ланцюжком, який, у свою чергу, має перевагу над черговістю. Щоб замінити ці правила пріоритету та сформувати підвираз, цілий вираз може бути узятий у дужки.

Зворотні посилання та підвирази¶

Зворотне посилання \n, де n є однією цифрою, відповідає підрядку, який раніше відповідав n-му підвиразу регулярного виразу в дужках.

Базові з Розширеними регулярні вирази¶

У базових регулярних виразах метасимволи ?, +, {, |, ( і ) втрачають своє особливе значення; замість цього використовуйте версії \?, \+, \{, \|, \( і \).

Повідомлення про помилки¶

Надсилайте повідомлення про помилки електронною поштою

та доступні

Відомі Помилки¶

Велика кількість повторень у конструкції {n,m} може призвести до того, що grep використовує багато пам'яті. Крім того, деякі інші незрозумілі регулярні вирази вимагають експоненційного часу та простору, і можуть призвести до того, що для grep не вистачить пам'яті.

Зворотні посилання дуже повільні і можуть вимагати експоненційного часу.

Наступні сторінки посібника¶

awk(1), cmp(1), diff(1), find(1), gzip(1), perl(1), sed(1), sort(1), xargs(1), zgrep(1), read(2), pcre(3), pcresyntax(3), pcrepattern(3), terminfo(5), glob(7), regex(7).

Сторінка підручника програміста POSIX¶

grep(1p).

Повна документація¶

доступний. Якщо програми info і grep правильно встановлені на вашому сайті, команда

info grep

ви зможете отримати доступ до повноцінного підручника.