pcre2grep - Online sa Cloud

PROGRAMA:

NAME

pcre2grep - isang grep na may mga regular na expression na katugma sa Perl.

SINOPSIS

pcre2grep [mga pagpipilian] [mahaba mga pagpipilian] [pattern] [landas1 landas2 ...]

DESCRIPTION

pcre2grep naghahanap ng mga file para sa mga pattern ng character, sa parehong paraan tulad ng iba pang mga grep command
gawin, ngunit ginagamit nito ang PCRE2 regular expression library upang suportahan ang mga pattern na iyon
tugma sa mga regular na expression ng Perl 5. Tingnan pcre2syntax(3) para sa isang mabilis-
buod ng sanggunian ng pattern syntax, o pcre2pattern(3) para sa buong paglalarawan ng
syntax at semantics ng mga regular na expression na sinusuportahan ng PCRE2.

Ang mga pattern, kung ibinibigay sa command line o sa isang hiwalay na file, ay ibinibigay nang wala
mga delimiter. Halimbawa:

pcre2grep Huwebes /etc/motd

Kung susubukan mong gumamit ng mga delimiter (halimbawa, sa pamamagitan ng pagpapaligid ng pattern na may mga slash, bilang
ay karaniwan sa mga script ng Perl), binibigyang-kahulugan ang mga ito bilang bahagi ng pattern. Quotes maaari ng
ang kurso ay gagamitin upang limitahan ang mga pattern sa command line dahil binibigyang-kahulugan ang mga ito ng
shell, at talagang kailangan ng mga panipi kung ang isang pattern ay naglalaman ng puting espasyo o shell
metacharacter.

Ang unang argumento na sumusunod sa anumang mga setting ng opsyon ay itinuturing bilang isang pattern na magiging
tugma kapag wala -e ni -f ay naroroon. Sa kabaligtaran, kapag ang isa o pareho sa mga pagpipiliang ito
ay ginagamit upang tukuyin ang mga pattern, ang lahat ng mga argumento ay itinuturing bilang mga pangalan ng landas. Kahit isa sa -e,
-f, o dapat magbigay ng pattern ng argumento.

Kung walang mga file na tinukoy, pcre2grep binabasa ang karaniwang input. Ang karaniwang input ay maaari ding
matukoy ng isang pangalan na binubuo ng isang gitling. Halimbawa:

pcre2grep ilang pattern na file1 - file3

Hinahanap ang mga input file sa bawat linya. Bilang default, ang bawat linya na tumutugma sa isang pattern ay
kinopya sa karaniwang output, at kung mayroong higit sa isang file, ang pangalan ng file ay output
sa simula ng bawat linya, na sinusundan ng isang tutuldok. Gayunpaman, may mga pagpipilian na maaari
baguhin kung paano pcre2grep kumikilos. Sa partikular, ang -M ginagawang posible ng opsyon na maghanap
mga string na sumasaklaw sa mga hangganan ng linya. Ang tumutukoy sa hangganan ng linya ay kinokontrol ng -N
(--bagong linya) pagpipilian.

Ang dami ng memory na ginagamit para sa pag-buffer ng mga file na ini-scan ay kinokontrol ng a
parameter na maaaring itakda ng --buffer-size opsyon. Ang default na halaga para dito
ang parameter ay tinukoy kung kailan pcre2grep ay binuo, na ang default na default ay 20K. A
bloke ng memorya ng tatlong beses ang laki na ito ay ginagamit (upang payagan ang pag-buffer "bago" at "pagkatapos"
mga linya). Ang isang error ay nangyayari kung ang isang linya ay umapaw sa buffer.

Ang mga pattern ay maaaring hindi hihigit sa 8K o BUFSIZ byte, alinman ang mas malaki. Ang BUFSIZ ay
tinukoy sa . Kapag mayroong higit sa isang pattern (tinukoy ng paggamit ng -e
at / o -f), ang bawat pattern ay inilalapat sa bawat linya sa pagkakasunud-sunod kung saan sila ay tinukoy,
maliban sa lahat ng -e ang mga pattern ay sinubukan bago ang -f mga pattern.

Bilang default, sa sandaling tumugma ang isang pattern sa isang linya, walang karagdagang pattern ang isasaalang-alang.
Gayunpaman, kung --kulay (O --kulay) ay ginagamit upang kulayan ang katugmang mga substring, o kung --lamang-
pagtutugma, --file-offset, O --line-offset ay ginagamit upang i-output lamang ang bahagi ng linya
na tumugma (maaaring literal na ipinakita, o bilang isang offset), ang pag-scan ay nagpapatuloy kaagad
kasunod ng laban, upang ang mga karagdagang tugma sa parehong linya ay mahahanap. Kung meron
maramihang mga pattern, lahat sila ay sinubukan sa natitirang bahagi ng linya, ngunit ang mga pattern na iyon
sundin ang isa na tumugma ay hindi sinubukan sa naunang bahagi ng linya.

Nangangahulugan ang pag-uugaling ito na maaaring makaapekto ang pagkakasunud-sunod kung saan tinukoy ang maraming pattern
ang output kapag ginamit ang isa sa mga opsyon sa itaas. Hindi na ito katulad ng ugali
GNU grep, na ngayon ay namamahala upang ipakita ang mga naunang tugma para sa mga susunod na pattern (hangga't
walang overlap).

Ang mga pattern na maaaring tumugma sa isang walang laman na string ay tinatanggap, ngunit walang laman na mga tugma ng string ay hindi kailanman
kinikilala. Ang isang halimbawa ay ang pattern na "(super)?(man)?", kung saan ang lahat ng mga bahagi ay
opsyonal. Hinahanap ng pattern na ito ang lahat ng paglitaw ng parehong "super" at "man"; iba ang output
mula sa pagtutugma sa "super|man" kapag ang mga tumutugmang substrings lang ang ipinapakita.

Kung ang LC_ALL or LC_CTYPE nakatakda ang variable ng kapaligiran, pcre2grep ginagamit ang halaga upang itakda ang a
locale kapag tumatawag sa PCRE2 library. Ang --lokal maaaring gamitin ang opsyon para i-override ito.

SUPORTA PARA SA COMPRESSED MGA FILE

Posibleng mag-compile pcre2grep upang ito ay gumagamit libz or libbz2 upang basahin ang mga file na kung saan
nagtatapos ang mga pangalan .gz or .bz2, ayon sa pagkakabanggit. Maaari mong malaman kung ang iyong binary ay may suporta
para sa isa o pareho sa mga uri ng file na ito sa pamamagitan ng pagpapatakbo nito gamit ang - Tumulong opsyon. Kung ang
walang naaangkop na suporta, ang mga file ay itinuturing bilang plain text. Ang karaniwang input ay
laging ganyan ang trato.

binary MGA FILE

Bilang default, ang isang file na naglalaman ng binary zero byte sa loob ng unang 1024 byte ay
kinilala bilang isang binary file, at espesyal na pinoproseso. (Kinikilala din ng GNU grep ang binary
file sa ganitong paraan.) Tingnan ang --binary-file opsyon para sa isang paraan ng pagbabago ng paraan
pinangangasiwaan ang mga binary file.

Opsyon

Ang pagkakasunud-sunod kung saan lumitaw ang ilan sa mga opsyon ay maaaring makaapekto sa output. Halimbawa, pareho ang
-h at -l nakakaapekto ang mga opsyon sa pag-print ng mga pangalan ng file. Alinman ang darating mamaya sa utos
linya na ang magkakabisa. Katulad nito, maliban kung saan nakasaad sa ibaba, kung isang opsyon
ay ibinigay ng dalawang beses, ang susunod na setting ay ginagamit. Ang mga numerong halaga para sa mga opsyon ay maaaring sundan ng
K o M, upang ipahiwatig ang multiplikasyon sa pamamagitan ng 1024 o 1024*1024 ayon sa pagkakabanggit.

-- Tinatapos nito ang listahan ng mga opsyon. Ito ay kapaki-pakinabang kung ang susunod na item sa
Ang command line ay nagsisimula sa isang gitling ngunit hindi ito isang opsyon. Ito ay nagbibigay-daan para sa
pagproseso ng mga pattern at mga pangalan ng file na nagsisimula sa mga gitling.

-A numero, --pagkatapos-konteksto=numero
Pagbubuhos numero mga linya ng konteksto pagkatapos ng bawat tugmang linya. Kung ang mga pangalan ng file at/o
Ang mga numero ng linya ay inilalabas, ang isang hyphen separator ay ginagamit sa halip na isang colon para sa
ang mga linya ng konteksto. Ang isang linya na naglalaman ng "--" ay output sa pagitan ng bawat pangkat ng mga linya,
maliban kung sila ay sa katunayan magkadikit sa input file. Ang halaga ng numero is
inaasahang medyo maliit. gayunpaman, pcre2grep garantiya na magkaroon ng hanggang 8K
ng sumusunod na teksto na magagamit para sa output ng konteksto.

-a, --text
Tratuhin ang mga binary file bilang text. Ito ay katumbas ng --binary-file=teksto.

-B numero, --before-context=numero
Pagbubuhos numero mga linya ng konteksto bago ang bawat tugmang linya. Kung ang mga pangalan ng file at/o
Ang mga numero ng linya ay inilalabas, ang isang hyphen separator ay ginagamit sa halip na isang colon para sa
ang mga linya ng konteksto. Ang isang linya na naglalaman ng "--" ay output sa pagitan ng bawat pangkat ng mga linya,
maliban kung sila ay sa katunayan magkadikit sa input file. Ang halaga ng numero is
inaasahang medyo maliit. gayunpaman, pcre2grep garantiya na magkaroon ng hanggang 8K
ng naunang teksto na magagamit para sa output ng konteksto.

--binary-files=salita
Tukuyin kung paano ipoproseso ang mga binary file. Kung ang salita ay "binary" (ang
default), ang pagtutugma ng pattern ay ginagawa sa mga binary file, ngunit ang tanging output ay
"Binary file mga tugma" kapag nagtagumpay ang isang laban. Kung ang salita ay "teksto", alin
ay katumbas ng -a or --text opsyon, ang mga binary file ay pinoproseso sa parehong
paraan tulad ng anumang iba pang file. Sa kasong ito, kapag nagtagumpay ang isang laban, maaaring ang output ay
binary na basura, na maaaring magkaroon ng masamang epekto kung ipapadala sa isang terminal. Kung ang salita
ay "walang tugma", na katumbas ng -I opsyon, ang mga binary file ay hindi
naproseso sa lahat; sila ay ipinapalagay na hindi interesado at nilaktawan nang wala
nagiging sanhi ng anumang output o nakakaapekto sa return code.

--buffer-size=numero
Itakda ang parameter na kumokontrol kung gaano karaming memory ang ginagamit para sa pag-buffer ng mga file na iyon
ay ini-scan.

-C numero, --context=numero
Pagbubuhos numero mga linya ng konteksto bago at pagkatapos ng bawat tugmang linya. Ito
ay katumbas ng pagtatakda ng pareho -A at -B sa parehong halaga.

-c, --bilang
Huwag mag-output ng mga linya mula sa mga file na ini-scan; sa halip ay i-output ang
bilang ng mga tugma (o hindi tugma kung -v ay ginagamit) na kung hindi man ay magkakaroon
sanhi upang ipakita ang mga linya. Bilang default, ang bilang na ito ay kapareho ng bilang ng
pinigilan ang mga linya, ngunit kung ang -M (multiline) na opsyon ay ginagamit (nang wala -v), doon
maaaring mas pinigilan ang mga linya kaysa sa bilang ng mga tugma.

Kung walang napiling linya, ang numerong zero ay output. Kung ang ilang mga file ay
ini-scan, isang bilang ang output para sa bawat isa sa kanila. Gayunpaman, kung ang --files-with-
posporo Ang opsyon ay ginagamit din, tanging ang mga file na ang bilang ay mas malaki sa zero
ay nakalista. Kailan -c ginagamit, ang -A, -B, at -C hindi pinapansin ang mga opsyon.

--kulay, --kulay
Kung ang opsyong ito ay ibinigay nang walang anumang data, ito ay katumbas ng "--colour=auto".
Kung kinakailangan ang data, dapat itong ibigay sa parehong item ng shell, na pinaghihiwalay ng isang
katumbas ng tanda.

--kulay=halaga, --kulay=halaga
Tinutukoy ng opsyong ito sa ilalim ng kung anong mga pangyayari ang mga bahagi ng isang linya na tumugma
ang isang pattern ay dapat na may kulay sa output. Bilang default, ang output ay hindi
may kulay. Ang halaga (na opsyonal, tingnan sa itaas) ay maaaring "hindi kailanman", "palagi", o
"auto". Sa huling kaso, ang pangkulay ay nangyayari lamang kung ang karaniwang output ay
konektado sa isang terminal. Mas maraming mapagkukunan ang ginagamit kapag pinagana ang pangkulay,
dahil sa pcre2grep kailangang hanapin ang lahat ng posibleng tugma sa isang linya, hindi lang
isa, para makulayan silang lahat.

Maaaring tukuyin ang kulay na ginamit sa pamamagitan ng pagtatakda ng variable ng kapaligiran
PCRE2GREP_COLOUR o PCRE2GREP_COLOUR. Ang halaga ng variable na ito ay dapat na a
string ng dalawang numero, na pinaghihiwalay ng semicolon. Direkta silang kinokopya sa
ang control string para sa pagtatakda ng kulay sa isang terminal, kaya ito ay sa iyo
responsibilidad upang matiyak na ang mga ito ay may katuturan. Kung wala sa kapaligiran
nakatakda ang mga variable, ang default ay "1;31", na nagbibigay ng pula.

-D aksyon, --mga device=aksyon
Kung ang isang input path ay hindi isang regular na file o isang direktoryo, ang "action" ay tumutukoy kung paano ito
ay ipoproseso. Ang mga wastong halaga ay "basahin" (ang default) o "laktawan" (tahimik
laktawan ang landas).

-d aksyon, --directories=aksyon
Kung ang isang input path ay isang direktoryo, ang "pagkilos" ay tumutukoy kung paano ito ipoproseso.
Ang mga wastong halaga ay "basahin" (ang default sa mga hindi Windows na kapaligiran, para sa
compatibility sa GNU grep), "recurse" (katumbas ng -r opsyon), o "laktawan"
(tahimik na laktawan ang landas, ang default sa mga kapaligiran ng Windows). Sa "basahin"
kaso, ang mga direktoryo ay binabasa na parang mga ordinaryong file. Sa ilang operasyon
sistema ang epekto ng pagbabasa ng isang direktoryo na tulad nito ay isang agarang end-of-file;
sa iba ay maaari itong magdulot ng pagkakamali.

-e huwaran, --regex=huwaran, --regexp=huwaran
Tukuyin ang isang pattern na itugma. Maaaring gamitin ang opsyong ito nang maraming beses sa pagkakasunud-sunod
upang tukuyin ang ilang mga pattern. Maaari din itong gamitin bilang isang paraan ng pagtukoy ng isang solong
pattern na nagsisimula sa isang gitling. Kailan -e ay ginagamit, walang pattern ng argumento ang kinuha
mula sa command line; ang lahat ng mga argumento ay itinuturing bilang mga pangalan ng file. Walang
limitasyon sa bilang ng mga pattern. Inilapat ang mga ito sa bawat linya sa pagkakasunud-sunod sa
na ang mga ito ay tinukoy hanggang sa isang tugma.

If -f ay ginagamit sa -e, ang mga pattern ng command line ay unang itinugma, na sinusundan ng
ang mga pattern mula sa (mga) file, independiyente sa pagkakasunud-sunod ng mga opsyong ito
ay tinukoy. Tandaan na maramihang paggamit ng -e ay hindi katulad ng isang pattern
may mga alternatibo. Halimbawa, hinahanap ng X|Y ang unang character sa isang linya na
X o Y, samantalang kung ang dalawang pattern ay ibinigay nang hiwalay, na may X muna,
pcre2grep hinahanap ang X kung ito ay naroroon, kahit na sinusundan nito ang Y sa linya. Hinahanap nito si Y
lamang kung walang X sa linya. Ito ay mahalaga lamang kung ikaw ay gumagamit -o or
--kulay upang ipakita ang (mga) bahagi ng linya na tumugma.

--ibukod=huwaran
Ang mga file (ngunit hindi mga direktoryo) na ang mga pangalan ay tumutugma sa pattern ay nilaktawan nang wala
pinoproseso. Nalalapat ito sa lahat ng mga file, nakalista man sa command line,
nakuha mula sa --file-list, o sa pamamagitan ng pag-scan sa isang direktoryo. Ang pattern ay isang PCRE2
regular na expression, at itinutugma laban sa panghuling bahagi ng pangalan ng file,
hindi ang buong landas. Ang -F, -w, at -x ang mga opsyon ay hindi nalalapat sa pattern na ito.
Ang opsyon ay maaaring ibigay sa anumang bilang ng beses upang tukuyin ang maramihan
mga pattern. Kung ang isang pangalan ng file ay tumutugma sa parehong an --isama at isang --ibukod pattern, ito
ay hindi kasama. Walang maikling form para sa opsyong ito.

--exclude-from=filename
Tratuhin ang bawat walang laman na linya ng file bilang data para sa isang --ibukod opsyon. Ano
bumubuo ng isang bagong linya kapag ang pagbabasa ng file ay ang default ng operating system.
Ang --bagong linya walang epekto ang opsyon sa opsyong ito. Ang pagpipiliang ito ay maaaring bigyan ng higit pa
kaysa sa isang beses upang tukuyin ang isang bilang ng mga file na babasahin.

--exclude-dir=huwaran
Ang mga direktoryo na ang mga pangalan ay tumutugma sa pattern ay nilaktawan nang hindi pinoproseso,
anuman ang setting ng - nagrerecursive opsyon. Nalalapat ito sa lahat ng mga direktoryo,
kung nakalista sa command line, nakuha mula sa --file-list, o sa pamamagitan ng pag-scan a
direktoryo ng magulang. Ang pattern ay isang regular na expression ng PCRE2, at itinutugma
laban sa huling bahagi ng pangalan ng direktoryo, hindi ang buong landas. Ang -F,
-w, at -x ang mga opsyon ay hindi nalalapat sa pattern na ito. Ang opsyon ay maaaring ibigay ng anuman
ilang beses upang matukoy ang higit sa isang pattern. Kung isang direktoryo
magkatugma pareho --include-dir at --exclude-dir, ito ay hindi kasama. Walang maikli
form para sa opsyong ito.

-F, --fixed-strings
Bigyang-kahulugan ang bawat pattern ng pagtutugma ng data bilang isang listahan ng mga nakapirming string, na pinaghihiwalay ng
mga bagong linya, sa halip na bilang isang regular na expression. Ano ang bumubuo ng isang bagong linya para sa
ang layuning ito ay kinokontrol ng --bagong linya pagpipilian Ang -w (tugma bilang isang salita) at
-x (itugma ang buong linya) na mga opsyon ay maaaring gamitin sa -F. Nalalapat ang mga ito sa bawat isa sa
nakapirming mga string. Ang isang linya ay pipiliin kung ang alinman sa mga nakapirming string ay matatagpuan dito
(napapailalim sa -w or -x, kung naroroon). Nalalapat lang ang opsyong ito sa mga pattern na
ay itinugma laban sa mga nilalaman ng mga file; hindi ito nalalapat sa mga pattern
tinukoy ng alinman sa --isama or --ibukod mga pagpipilian.

-f filename, --file=filename
Basahin ang mga pattern mula sa file, isa sa bawat linya, at itugma ang mga ito sa bawat linya ng
input. Ano ang bumubuo ng isang bagong linya kapag nagbabasa ng file ay ang operating
default ng system. Ang --bagong linya walang epekto ang opsyon sa opsyong ito. Kasunod
inaalis ang puting espasyo sa bawat linya, at binabalewala ang mga blangkong linya. Isang walang laman
file ay walang mga pattern at samakatuwid ay tumutugma sa wala. Tingnan din ang mga komento
tungkol sa maraming pattern kumpara sa isang pattern na may mga alternatibo sa
paglalarawan ng -e sa itaas.

Kung ang pagpipiliang ito ay ibinigay ng higit sa isang beses, ang lahat ng mga tinukoy na file ay mababasa. Isang data
Ang linya ay output kung alinman sa mga pattern ang tumutugma dito. Ang pangalan ng file ay maaaring ibigay bilang "-"
upang sumangguni sa karaniwang input. Kailan -f ay ginagamit, mga pattern na tinukoy sa
command line gamit ang -e maaari ring naroroon; sila ay nasubok bago ang file
mga pattern. Gayunpaman, walang ibang pattern ang kinuha mula sa command line; lahat
ang mga argumento ay itinuturing bilang mga pangalan ng mga landas na hahanapin.

--file-list=filename
Magbasa ng listahan ng mga file at/o mga direktoryo na i-scan mula sa ibinigay
file, isa bawat linya. Ang sumusunod na puting espasyo ay tinanggal mula sa bawat linya, at blangko
hindi pinapansin ang mga linya. Pinoproseso ang mga path na ito bago ang anumang nakalista sa
command line. Ang pangalan ng file ay maaaring ibigay bilang "-" upang sumangguni sa karaniwang input.
If --file at --file-list ay parehong tinukoy bilang "-", ang mga pattern ay unang binabasa.
Ito ay kapaki-pakinabang lamang kapag ang karaniwang input ay isang terminal, kung saan higit pa
mga linya (ang listahan ng mga file) ay maaaring basahin pagkatapos ng isang end-of-file na indikasyon. Kung ito
Ang pagpipilian ay ibinibigay ng higit sa isang beses, ang lahat ng mga tinukoy na file ay nabasa.

--file-offset
Sa halip na ipakita ang mga linya o bahagi ng mga linya na tumutugma, ipakita ang bawat tugma bilang isang
offset mula sa simula ng file at isang haba, na pinaghihiwalay ng kuwit. Dito sa
mode, walang ipinapakitang konteksto. Ibig sabihin, ang -A, -B, at -C hindi pinapansin ang mga opsyon. Kung
mayroong higit sa isang tugma sa isang linya, bawat isa sa kanila ay ipinapakita nang hiwalay. Ito
ang opsyon ay kapwa eksklusibo sa --line-offset at --lamang-matching.

-H, --with-filename
Pilitin ang pagsasama ng pangalan ng file sa simula ng mga linya ng output kapag naghahanap
isang file. Bilang default, hindi ipinapakita ang pangalan ng file sa kasong ito. Para sa
pagtutugma ng mga linya, ang pangalan ng file ay sinusundan ng isang colon; para sa mga linya ng konteksto, a
ginagamit ang hyphen separator. Kung ang isang numero ng linya ay inilalabas din, ito ay sumusunod sa
pangalan ng file. Kapag ang -M ang opsyon ay nagdudulot ng pattern na tumugma sa higit sa isang linya, lamang
ang una ay pinangungunahan ng pangalan ng file.

-h, --walang-filename
Pigilan ang mga pangalan ng output file kapag naghahanap ng maramihang mga file. Bilang default, file
ipinapakita ang mga pangalan kapag maraming file ang hinanap. Para sa pagtutugma ng mga linya, ang file
ang pangalan ay sinusundan ng isang tutuldok; para sa mga linya ng konteksto, ginagamit ang isang hyphen separator. Kung
ang isang numero ng linya ay inilalabas din, ito ay sumusunod sa pangalan ng file.

- Tumulong Mag-output ng mensahe ng tulong, na nagbibigay ng mga maikling detalye ng mga opsyon sa command at uri ng file
suporta, at pagkatapos ay lumabas. Ang anumang bagay sa command line ay hindi pinansin.

-I Huwag pansinin ang mga binary file. Ito ay katumbas ng --binary-file=walang tugma.

-i, --balewalain-kaso
Huwag pansinin ang upper/lower case na pagkakaiba sa panahon ng paghahambing.

--isama=huwaran
Kung mayroon man --isama mga pattern ay tinukoy, ang tanging mga file na naproseso ay
ang mga tumutugma sa isa sa mga pattern (at hindi tumutugma sa isang --ibukod pattern).
Ang pagpipiliang ito ay hindi nakakaapekto sa mga direktoryo, ngunit nalalapat ito sa lahat ng mga file, kung
nakalista sa command line, nakuha mula sa --file-list, o sa pamamagitan ng pag-scan a
direktoryo. Ang pattern ay isang regular na expression ng PCRE2, at itinutugma laban sa
huling bahagi ng pangalan ng file, hindi ang buong landas. Ang -F, -w, at -x
ang mga opsyon ay hindi nalalapat sa pattern na ito. Ang opsyon ay maaaring ibigay ng anumang bilang ng
beses. Kung ang isang pangalan ng file ay tumutugma sa parehong an --isama at isang --ibukod pattern, ito ay
hindi kasama. Walang maikling form para sa opsyong ito.

--include-from=filename
Tratuhin ang bawat walang laman na linya ng file bilang data para sa isang --isama opsyon. Ano
bumubuo ng isang bagong linya para sa layuning ito ay ang default ng operating system. Ang
--bagong linya walang epekto ang opsyon sa opsyong ito. Ang pagpipiliang ito ay maaaring ibigay sa alinman
ilang beses; lahat ng mga file ay nabasa.

--include-dir=huwaran
Kung mayroon man --include-dir mga pattern ay tinukoy, ang tanging mga direktoryo na
naproseso ay ang mga tumutugma sa isa sa mga pattern (at hindi tumutugma sa isang
--exclude-dir pattern). Nalalapat ito sa lahat ng mga direktoryo, nakalista man sa
command line, nakuha mula sa --file-list, o sa pamamagitan ng pag-scan sa isang direktoryo ng magulang. Ang
Ang pattern ay isang regular na expression ng PCRE2, at itinutugma laban sa pangwakas
bahagi ng pangalan ng direktoryo, hindi ang buong landas. Ang -F, -w, at -x pagpipilian
huwag ilapat sa pattern na ito. Ang opsyon ay maaaring ibigay sa anumang bilang ng beses. Kung ang
ang direktoryo ay tumutugma sa pareho --include-dir at --exclude-dir, ito ay hindi kasama. meron
walang maikling anyo para sa opsyong ito.

-L, --files-walang-tugma
Sa halip na mag-output ng mga linya mula sa mga file, i-output lamang ang mga pangalan ng mga file
na hindi naglalaman ng anumang mga linya na magiging output. Ang bawat pangalan ng file ay
output nang isang beses, sa isang hiwalay na linya.

-l, --files-with-matches
Sa halip na mag-output ng mga linya mula sa mga file, i-output lamang ang mga pangalan ng mga file
naglalaman ng mga linya na sana ay output. Ang bawat pangalan ng file ay output nang isang beses, naka-on
isang hiwalay na linya. Karaniwang humihinto ang paghahanap kapag may nakitang katugmang linya
isang file. Gayunpaman, kung ang -c (count) na opsyon ay ginagamit din, ang pagtutugma ay nagpapatuloy sa
upang makuha ang tamang bilang, at ang mga file na mayroong kahit isang tugma
ay nakalista kasama ng kanilang mga bilang. Gamit ang opsyong ito sa -c ay isang paraan ng
pinipigilan ang listahan ng mga file na walang tugma.

--label=pangalan
Ang pagpipiliang ito ay nagbibigay ng isang pangalan na gagamitin para sa karaniwang input kapag ang mga pangalan ng file
ay ginagawang output. Kung hindi ibinigay, "(standard input)" ang ginagamit. Walang maikli
form para sa opsyong ito.

--line-buffered
Kapag ibinigay ang opsyong ito, binabasa at pinoproseso ang pag-input sa bawat linya, at ang
ang output ay namumula pagkatapos ng bawat pagsulat. Bilang default, binabasa ang input sa malalaking tipak,
maliban na lamang kung pcre2grep maaaring matukoy na ito ay nagbabasa mula sa isang terminal (na
kasalukuyang posible lamang sa mga kapaligirang tulad ng Unix). Ang output sa terminal ay
karaniwang awtomatikong na-flush ng operating system. Ang pagpipiliang ito ay maaaring
kapaki-pakinabang kapag ang input o output ay naka-attach sa isang pipe at hindi mo gusto
pcre2grep upang buffer up ng malaking halaga ng data. Gayunpaman, ang paggamit nito ay makakaapekto
pagganap, at ang -M (multiline) na opsyon ay hindi na gagana.

--line-offset
Sa halip na ipakita ang mga linya o bahagi ng mga linya na tumutugma, ipakita ang bawat tugma bilang isang linya
numero, ang offset mula sa simula ng linya, at isang haba. Ang numero ng linya ay
winakasan ng colon (gaya ng dati; tingnan ang -n opsyon), at ang offset at haba
ay pinaghihiwalay ng kuwit. Sa mode na ito, walang ipinapakitang konteksto. Ibig sabihin, ang -A,
-B, at -C hindi pinapansin ang mga opsyon. Kung mayroong higit sa isang tugma sa isang linya, bawat isa
sa kanila ay ipinapakita nang hiwalay. Ang pagpipiliang ito ay kapwa eksklusibo sa --file-
natapos at --lamang-matching.

--lokal=lokal na pangalan
Tinutukoy ng opsyong ito ang isang lokal na gagamitin para sa pagtutugma ng pattern. Ino-override nito ang
halaga sa LC_ALL or LC_CTYPE mga variable ng kapaligiran. Kung walang locale
tinukoy, ang default ng PCRE2 library (kadalasan ang "C" locale) ay ginagamit. doon
ay walang maikling anyo para sa opsyong ito.

--match-limit=numero
Ang pagproseso ng ilang regular na pattern ng expression ay maaaring mangailangan ng napakalaking halaga ng
memorya, na humahantong sa ilang mga kaso sa isang pag-crash ng programa kung hindi sapat ang magagamit.
Ang iba pang mga pattern ay maaaring tumagal ng napakatagal na oras upang mahanap ang lahat ng posibleng pagtutugma
mga string. Ang pcre2_match() function na tinatawag ng pcre2grep upang gawin ang
Ang pagtutugma ay may dalawang parameter na maaaring limitahan ang mga mapagkukunang ginagamit nito.

Ang --match-limit ang opsyon ay nagbibigay ng paraan ng paglilimita sa paggamit ng mapagkukunan kapag
mga pattern ng pagproseso na hindi magtutugma, ngunit may napakalaking
bilang ng mga posibilidad sa kanilang mga puno ng paghahanap. Ang klasikong halimbawa ay isang pattern
na gumagamit ng nested na walang limitasyong pag-uulit. Sa panloob, ang PCRE2 ay gumagamit ng isang function na tinatawag
tugma() na paulit-ulit nitong tinatawag (minsan recursively). Ang limitasyon na itinakda ni
--match-limit ay ipinapataw sa dami ng beses na tinawag ang function na ito sa panahon ng a
tugma, na may epekto ng paglilimita sa dami ng backtracking na maaaring tumagal
sa halip.

Ang --recursion-limit ang pagpipilian ay katulad ng --match-limit, ngunit sa halip na
nililimitahan ang kabuuang bilang ng beses na tugma() ay tinatawag na, nililimitahan nito ang lalim
ng mga recursive na tawag, na naglilimita naman sa dami ng memory na magagamit.
Ang lalim ng recursion ay isang mas maliit na bilang kaysa sa kabuuang bilang ng mga tawag, dahil
hindi lahat ng tawag sa tugma() ay recursive. Ang limitasyong ito ay magagamit lamang kung ito ay nakatakda
mas maliit sa --match-limit.

Walang mga maikling form para sa mga opsyong ito. Ang mga default na setting ay tinukoy
kapag ang PCRE2 library ay pinagsama-sama, na ang default ay 10 milyon.

-M, --multiline
Payagan ang mga pattern na tumugma sa higit sa isang linya. Kapag ibinigay ang pagpipiliang ito, mga pattern
maaaring kapaki-pakinabang na maglaman ng mga literal na bagong linyang character at panloob na paglitaw ng ^
at $ character. Ang output para sa isang matagumpay na laban ay maaaring binubuo ng higit sa isa
linya. Ang una ay ang linya kung saan nagsimula ang laban, at ang huli ay ang linya
kung saan natapos ang laban. Kung ang katugmang string ay nagtatapos sa isang bagong linya na sequence ang
magtatapos ang output sa dulo ng linyang iyon.

Kapag ang opsyong ito ay nakatakda, ang PCRE2 library ay tinatawag sa "multiline" mode.
Gayunpaman, pcre2grep pinoproseso pa rin ang input line by line. Ang pagkakaiba ay
na ang isang katugmang string ay maaaring lumampas sa dulo ng isang linya at magpatuloy sa isa o
mas kasunod na mga linya. Ang pagkakasunud-sunod ng bagong linya ay dapat na tumugma bilang bahagi ng
pattern. Halimbawa, upang mahanap ang pariralang "regular na expression" sa isang file kung saan
Ang "regular" ay maaaring nasa dulo ng isang linya at "expression" sa simula ng
susunod na linya, maaari mong gamitin ang command na ito:

pcre2grep -M 'regular\s+expression'

Ang \s escape sequence ay tumutugma sa anumang white space na character, kabilang ang mga bagong linya,
at sinusundan ng + upang tumugma sa trailing na puting espasyo sa unang linya bilang
pati na rin ang posibleng paghawak ng dalawang-character na pagkakasunod-sunod ng bagong linya.

May limitasyon sa bilang ng mga linya na maaaring itugma, na ipinataw sa pamamagitan ng paraan
na pcre2grep buffer ang input file habang ini-scan ito. gayunpaman, pcre2grep Tinitiyak
na hindi bababa sa 8K character o ang natitirang bahagi ng file (alinman ang mas maikli)
ay available para sa forward matching, at katulad din ng nakaraang 8K character (o
lahat ng nakaraang character, kung mas kaunti sa 8K) ay garantisadong available
para sa pagtingin sa likod ng mga pahayag. Ang -M hindi gumagana ang opsyon kapag ang input ay read line
sa pamamagitan ng linya (tingnan --line-buffered.)

-N uri ng bagong linya, --bagong linya=uri ng bagong linya
Sinusuportahan ng PCRE2 library ang limang magkakaibang mga kombensiyon para sa pagtukoy sa mga dulo ng
mga linya. Ang mga ito ay ang single-character sequences na CR (carriage return) at LF
(linefeed), ang two-character sequence na CRLF, isang "anycrlf" convention, na
kinikilala ang alinman sa naunang tatlong uri, at isang "anumang" kumbensyon, kung saan
anumang Unicode line ending sequence ay ipinapalagay na magtatapos sa isang linya. Ang Unicode sequence
ay ang tatlong nabanggit, kasama ang VT (vertical tab, U+000B), FF (form feed,
U+000C), NEL (susunod na linya, U+0085), LS (line separator, U+2028), at PS (talata
separator, U+2029).

Kapag ang PCRE2 library ay binuo, ang isang default na line-ending sequence ay tinukoy.
Ito ay karaniwang ang karaniwang sequence para sa operating system. Maliban kung
kung hindi man ay tinukoy ng opsyong ito, pcre2grep gumagamit ng default ng library. Ang
Ang mga posibleng value para sa opsyong ito ay CR, LF, CRLF, ANYCRLF, o ANY. Ginagawa ito
posibleng gamitin pcre2grep upang i-scan ang mga file na nagmula sa ibang mga kapaligiran
nang hindi kinakailangang baguhin ang kanilang mga dulo ng linya. Kung ang data na ini-scan
ay hindi sumasang-ayon sa convention na itinakda ng opsyong ito, pcre2grep maaaring kumilos sa
kakaibang paraan. Tandaan na ang opsyong ito ay hindi nalalapat sa mga file na tinukoy ng -f,
--bukod-sa, O --isama-mula sa mga opsyon, na inaasahang gagamit ng
karaniwang bagong linya ng pagkakasunod-sunod ng operating system.

-n, --numero ng linya
Unahan ang bawat linya ng output sa pamamagitan ng numero ng linya nito sa file, na sinusundan ng isang colon para sa
pagtutugma ng mga linya o gitling para sa mga linya ng konteksto. Kung ang pangalan ng file ay din
output, nauuna ito sa numero ng linya. Kapag ang -M ang pagpipilian ay nagiging sanhi ng isang pattern sa
tumugma sa higit sa isang linya, ang una lamang ang nauuna sa numero ng linya nito. Ito
ang pagpipilian ay pinilit kung --line-offset Ginagamit.

--hindi-jit Kung ang PCRE2 library ay binuo na may suporta para sa just-in-time na pag-compile (na
pinapabilis ang pagtutugma), pcre2grep awtomatikong ginagamit ito, maliban kung ito ay
tahasang hindi pinagana sa oras ng pagbuo. Maaaring gamitin ang opsyong ito upang huwag paganahin ang paggamit ng
JIT sa oras ng pagtakbo. Ito ay ibinigay para sa pagsubok at mga problema sa pag-ikot. Ito
hindi dapat kailanganin sa normal na paggamit.

-o, --lamang-matching
Ipakita lamang ang bahagi ng linya na tumugma sa isang pattern sa halip na ang buong linya.
Sa mode na ito, walang ipinapakitang konteksto. Ibig sabihin, ang -A, -B, at -C ang mga pagpipilian ay
hindi pinansin. Kung mayroong higit sa isang tugma sa isang linya, ang bawat isa sa kanila ay ipinapakita
magkahiwalay. Kung -o ay pinagsama sa -v (baligtarin ang kahulugan ng tugma upang mahanap
hindi tugmang mga linya), walang output na nabuo, ngunit ang return code ay nakatakda
nararapat. Kung walang laman ang katugmang bahagi ng linya, walang output
maliban kung ang pangalan ng file o numero ng linya ay naka-print, kung saan ang mga ito ay
ipinapakita sa isang walang laman na linya. Ang pagpipiliang ito ay kapwa eksklusibo sa --file-
natapos at --line-offset.

-onumero, --lamang-matching=numero
Ipakita lamang ang bahagi ng linya na tumugma sa pagkuha ng mga panaklong ng
binigay na numero. Hanggang 32 kumukuha ng panaklong ang sinusuportahan, at -o0 ay
katumbas ng -o walang numero. Dahil ang mga pagpipiliang ito ay maaaring ibigay nang walang isang
argumento (tingnan sa itaas), kung mayroong isang argumento, dapat itong ibigay sa parehong
shell item, halimbawa, -o3 o --only-matching=2. Ang mga komentong ibinigay para sa
nalalapat din sa kasong ito ang hindi argumentong kaso sa itaas. Kung ang tinukoy na pagkuha
ang mga panaklong ay hindi umiiral sa pattern, o hindi itinakda sa tugma, wala
ay output maliban kung ang pangalan ng file o numero ng linya ay inilalabas.

Kung ang pagpipiliang ito ay ibinigay ng maraming beses, maraming mga substring ang output, sa
ibigay ang mga pagpipilian. Halimbawa, -o3 -o1 -o3 ang nagiging sanhi ng mga substring
itinugma sa pamamagitan ng pagkuha ng mga panaklong 3 at 1 at pagkatapos ay 3 muli upang maging output. Sa pamamagitan ng
default, walang separator (ngunit tingnan ang susunod na opsyon).

--om-separator=teksto
Tumukoy ng naghihiwalay na string para sa maraming paglitaw ng -o. Ang default ay isang
walang laman na string. Ang paghihiwalay ng mga string ay hindi kailanman kinukulayan.

-q, --tahimik
Magtrabaho nang tahimik, iyon ay, walang ipinapakita maliban sa mga mensahe ng error. Ang katayuan ng paglabas
nagsasaad kung may nakitang mga tugma o wala.

-r, - nagrerecursive
Kung ang anumang ibinigay na landas ay isang direktoryo, muling i-scan ang mga file na nilalaman nito, kumukuha
tala ng alinman --isama at --ibukod mga setting. Bilang default, ang isang direktoryo ay binabasa bilang
isang normal na file; sa ilang operating system, nagbibigay ito ng agarang end-of-file.
Ang pagpipiliang ito ay isang shorthand para sa pagtatakda ng -d opsyon sa "recurse".

--recursion-limit=numero
Tingnan --match-limit sa itaas.

-s, --walang-mensahe
Pigilan ang mga mensahe ng error tungkol sa mga wala o hindi nababasang mga file. Ang ganitong mga file ay
tahimik na nilampasan. Gayunpaman, ang return code ay 2 pa rin, kahit na may nakitang mga tugma
sa ibang mga file.

-u, --utf-8
Gumana sa UTF-8 mode. Ang pagpipiliang ito ay magagamit lamang kung ang PCRE2 ay naipon
na may suporta sa UTF-8. Lahat ng mga pattern (kabilang ang mga para sa alinman --ibukod at
--isama mga opsyon) at lahat ng mga linya ng paksa na na-scan ay dapat na wastong mga string
ng UTF-8 na mga character.

-V, --bersyon
Isulat ang mga numero ng bersyon ng pcre2grep at ang PCRE2 library sa pamantayan
output at pagkatapos ay lumabas. Ang anumang bagay sa command line ay binabalewala.

-v, --invert-match
Baligtarin ang kahulugan ng tugma, upang ang mga linya na gawin hindi tumugma sa alinman sa
ang mga pattern ay ang mga nahanap.

-w, --salita-regex, --salita-regexp
Pilitin ang mga pattern na tumugma lamang sa mga buong salita. Ito ay katumbas ng pagkakaroon ng \b at
ang simula at pagtatapos ng pattern. Nalalapat lang ang opsyong ito sa mga pattern na
ay itinugma laban sa mga nilalaman ng mga file; hindi ito nalalapat sa mga pattern
tinukoy ng alinman sa --isama or --ibukod mga pagpipilian.

-x, --line-regex, --line-regexp
Pilitin ang mga pattern na i-angkla (dapat magsimulang tumugma ang bawat isa sa simula ng
isang linya) at bilang karagdagan, hilingin sa kanila na tumugma sa buong linya. Ito ay katumbas
sa pagkakaroon ng ^ at $ na mga character sa simula at dulo ng bawat alternatibong pinakamataas na antas
sangay sa bawat pattern. Nalalapat lang ang opsyong ito sa mga pattern na
tumugma laban sa mga nilalaman ng mga file; hindi ito nalalapat sa mga pattern na tinukoy
ng alinman sa --isama or --ibukod mga pagpipilian.

Kapaligiran MGA VARIABLE

Ang mga variable ng kapaligiran LC_ALL at LC_CTYPE ay sinusuri, sa ganoong pagkakasunud-sunod, para sa isang lokal.
Ang unang nakatakda ay ginagamit. Ito ay maaaring ma-override ng --lokal opsyon. Kung hindi
locale ay nakatakda, ang default ng PCRE2 library (karaniwan ay ang "C" locale) ay ginagamit.

NEWLINES

Ang -N (--bagong linya) opsyon ay nagbibigay-daan pcre2grep upang i-scan ang mga file na may ibang bagong linya
mga kumbensyon mula sa default. Anumang bahagi ng input file na nakasulat sa
ang karaniwang output ay kinopya nang magkapareho, kasama ang anumang mga pagkakasunud-sunod ng bagong linya na mayroon sila sa
input. Gayunpaman, ang setting ng opsyong ito ay hindi nakakaapekto sa interpretasyon ng mga file
tinukoy ng -f, --bukod-sa, O --isama-mula sa mga opsyon, na ipinapalagay na gagamitin
ang karaniwang sequence ng bagong linya ng operating system, at hindi rin ito nakakaapekto sa paraan kung paano
pcre2grep nagsusulat ng mga mensaheng pang-impormasyon sa karaniwang error at mga stream ng output. Para sa
ang mga ito ay gumagamit ng string na "\n" upang ipahiwatig ang mga bagong linya, na umaasa sa CI/O library sa
i-convert ito sa isang naaangkop na pagkakasunod-sunod.

Opsyon Kakayahan na

Marami sa maikli at mahabang anyo ng pcre2grepAng mga pagpipilian ni ay kapareho ng sa GNU grep
programa. Anumang mahabang opsyon ng form --xxx-regexp (terminolohiya ng GNU) ay magagamit din bilang
--xxx-regex (terminolohiya ng PCRE2). Gayunpaman, ang --file-list, --file-offset, --include-dir,
--line-offset, --lokal, --match-limit, -M, --multiline, -N, --bagong linya, --om-separator,
--recursion-limit, -u, at --utf-8 ang mga pagpipilian ay tiyak sa pcre2grep, gaya ng paggamit ng
--lamang-matching opsyon na may kumukuhang numero ng panaklong.

Bagama't karamihan sa mga karaniwang opsyon ay gumagana sa parehong paraan, ang ilan ay naiiba sa pcre2grep.
Halimbawa, ang --isama Ang argumento ng opsyon ay isang glob para sa GNU grep, ngunit isang regular
pagpapahayag para sa pcre2grep. Kung pareho ang -c at -l ibinibigay ang mga opsyon, ang mga listahan ng GNU grep lamang
mga pangalan ng file, nang walang bilang, ngunit pcre2grep nagbibigay din ng mga bilang.

Opsyon SA DATA

Mayroong apat na magkakaibang paraan kung saan maaaring tukuyin ang isang opsyon na may data. Kung maikli
form na opsyon ay ginagamit, ang data ay maaaring sundin kaagad, o (na may isang pagbubukod) sa susunod
item ng command line. Halimbawa:

-f/some/file
-f /some/file

Ang pagbubukod ay ang -o opsyon, na maaaring lumitaw nang may data o walang. Dahil dito,
kung ang data ay naroroon, dapat itong sumunod kaagad sa parehong item, halimbawa -o3.

Kung gagamitin ang isang long form na opsyon, maaaring lumabas ang data sa parehong command line item,
pinaghihiwalay ng isang katumbas na karakter, o (na may dalawang pagbubukod) maaari itong lumitaw sa susunod
item ng command line. Halimbawa:

--file=/some/file
--file /some/file

Tandaan, gayunpaman, na kung nais mong magbigay ng isang pangalan ng file na nagsisimula sa ~ bilang data sa isang shell
command, at palawakin ang shell ~ sa isang home directory, dapat mong paghiwalayin ang pangalan ng file
mula sa opsyon, dahil hindi tinatrato ng shell ang ~ lalo na maliban kung ito ay sa simula ng
isang bagay.

Ang mga pagbubukod sa itaas ay ang --kulay (O --kulay) At --lamang-matching mga pagpipilian, para sa
na ang data ay opsyonal. Kung may data ang isa sa mga opsyong ito, dapat itong ibigay
ang unang anyo, gamit ang isang katumbas na karakter. Kung hindi pcre2grep ay ipagpalagay na wala itong
data.

PAGKAKITA MGA KAMALI

Posibleng magbigay ng isang regular na expression na tumatagal ng napakatagal na panahon upang mabigong tumugma
ilang linya. Ang ganitong mga pattern ay karaniwang nagsasangkot ng mga nested na hindi tiyak na pag-uulit, halimbawa:
(a+)*\d kapag itinugma sa isang linya ng mga a na walang pinal na digit. Ang pagtutugma ng PCRE2
Ang function ay may limitasyon sa mapagkukunan na nagiging sanhi ng pag-abort nito sa mga sitwasyong ito. Kung ito
nangyayari, pcre2grep naglalabas ng mensahe ng error at ang linyang nagdulot ng problema sa
karaniwang stream ng error. Kung mayroong higit sa 20 tulad ng mga pagkakamali, pcre2grep sumusuko.

Ang --match-limit opsyon ng pcre2grep maaaring gamitin upang itakda ang kabuuang limitasyon ng mapagkukunan; doon
ay tinatawag na pangalawang opsyon --recursion-limit na nagtatakda ng limitasyon sa dami ng memorya
(karaniwang stack) na ginagamit (tingnan ang talakayan ng mga opsyon na ito sa itaas).

DIAGNOSTICS

Ang katayuan sa paglabas ay 0 kung may nakitang tugma, 1 kung walang nakitang tugma, at 2 para sa syntax
mga error, napakahabang linya, wala o hindi naa-access na mga file (kahit na natagpuan ang mga tugma sa
iba pang mga file) o masyadong maraming pagtutugma ng mga error. Gamit ang -s opsyon upang sugpuin ang mga mensahe ng error
tungkol sa hindi naa-access na mga file ay hindi nakakaapekto sa return code.

Gamitin ang pcre2grep online gamit ang mga serbisyo ng onworks.net