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

--help

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

-V, --version

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

Синтаксис шаблонів¶

-E, --extended-regexp

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

-F, --fixed-strings

ЗРАЗОК розглядається як фіксовані рядки, а не регулярні вирази.

-G, --basic-regexp

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

-P, --perl-regexp

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

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

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

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

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

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

-i, --ignore-case

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

--no-ignore-case

У зразках та вхідних даних не ігнорується регістр. Це типове значення. Цей параметр корисний для передавання до скриптів оболонки, які вже використовують -i, для скасування його ефектів, оскільки ці два параметри перемикають один одного.

-v, --invert-match

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

-w, --word-regexp

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

-x, --line-regexp

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

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

-c, --count

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

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

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

-L, --files-without-match

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

-l, --files-with-matches

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

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

Пошук у файлі припиняється після вказаного ЧИСЛА рядків, які збіглися. Якщо ЧИСЛО є нулем, grep припиняє обробку без читання вхідних даних. Значення ЧИСЛО, яке рівне -1, означає нескінченність і grep не зупиняється; це типове значення. Якщо ввід відбувається зі звичайного файлу, 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

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

-h, --no-filename

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

--label=НАЗВА

Вказує ніби ввід надходить з файла з назвою НАЗВА. Це може бути корисно для команд, які перетворюють вміст файлу перед пошуком, наприклад, gzip -cd foo.gz | grep --label=foo -H 'ЗРАЗОК'. Дивіться також параметр -H.

-n, --line-number

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

-T, --initial-tab

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

-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 команда не працює, про що виводиться попередження.

--group-separator=РОЗДІЛЬНИК

Коли використовуються опції -A, -B або -C, друкуйте РОЗДІЛЬНИК замість -- між групами рядків.

--no-group-separator

Коли використовуються опції -A, -B або -C, не друкуйте роздільник між групами рядків.

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

-a, --text

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

--binary-files=ТИП

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

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

Якщо ТИП є 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:], [:blank:], [: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-му підвиразу регулярного виразу в дужках.

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

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

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

Надсилайте повідомлення про помилки електронною поштою на адресу на адресу повідомлення про помилки ⟨bug-grep@gnu.org⟩. An Доступні архів електронної пошти ⟨https://lists.gnu.org/mailman/listinfo/bug-grep⟩ і засіб відстеження помилок ⟨https://debbugs.gnu.org/cgi/pkgreport.cgi?package=grep⟩

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

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

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

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

awk(1), cmp(1), diff(1), find(1), perl(1), sed(1), sort(1), xargs(1), read(2), pcre2(3), pcre2syntax(3), pcre2pattern(3), terminfo(5), glob(7), regex(7)

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

Доступний повний посібник ⟨https://www.gnu.org/software/grep/manual/⟩. Якщо програми info і grep правильно встановлені на вашому сайті, команда

info grep

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