.TH agrep 1 "21 نوامبر 2004" "TRE agrep 0.9.0"
.SH "نام (NAME)"
agrep \- چاپ خطوطی که به‌طور تقریبی با یک الگو مطابقت دارند
.SH "خلاصه دستور (SYNOPSIS)"
.B agrep
.RI [ OPTION ]...
.I PATTERN
.RI [ FILE ]...
.SH "توضیحات (DESCRIPTION)"
تطابق‌های تقریبی
.I PATTERN
را در هر
.I FILE
یا ورودی استاندارد جستجو می‌کند. برای نمونه: `agrep \-2 optimize foo.txt' تمام خطوطی از فایل `foo.txt' را چاپ می‌کند که با "optimize" با حداکثر دو خطا تطابق دارند؛ به عنوان مثال خطوطی که شامل "optimise"، "optmise" و "opitmize" هستند همگی مطابقت داده می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.SS "انتخاب و تفسیر عبارت باقاعده:"
.TP
.BI \-e " PATTERN" "\fR,\fP \-\^\-regexp=" PATTERN
استفاده از
.I PATTERN
به عنوان یک عبارت باقاعده؛ برای محافظت از الگوهایی که با
.B \-
آغاز می‌شوند مفید است.
.TP
.BR \-i ", " \-\^\-ignore\-case
صرف‌نظر کردن از تمایز حروف کوچک و بزرگ (طبق تعریف locale فعلی) در
.I PATTERN
و فایل‌های ورودی.
.TP
.BR \-k ", " \-\^\-literal
در نظر گرفتن
.I PATTERN
به عنوان یک رشته لفظی (literal)، یعنی یک رشته ثابت و بدون نویسه‌های خاص.
.TP
.BR \-w ", " \-\^\-word\-regexp
اجبار
.I PATTERN
به تطابق تنها با کلمات کامل. یک «کلمه کامل» زیررشته‌ای است که یا در ابتدای رکورد آغاز می‌شود و یا پیش از آن یک نویسهٔ غیرسازنده کلمه قرار دارد. به همین ترتیب، زیررشته باید در انتهای رکورد به پایان برسد یا پس از آن یک نویسهٔ غیرسازنده کلمه بیاید. نویسه‌های سازنده کلمه شامل نویسه‌های الفبایی‌عددی (طبق تعریف locale فعلی) و نویسه زیرخط (underscore) هستند. توجه داشته باشید که نویسه‌های غیرسازنده کلمه
.B باید
تطابق را در بر گیرند؛ آن‌ها نمی‌توانند به عنوان خطا محاسبه شوند.
.SS "تنظیمات تطابق تقریبی:"
.TP
.BI \-D " NUM" "\fR,\fP \-\^\-delete\-cost=" NUM
تنظیم هزینه نویسه‌های جاافتاده بر روی
.IR NUM .
.TP
.BI \-I " NUM" "\fR,\fP \-\^\-insert\-cost=" NUM
تنظیم هزینه نویسه‌های اضافی بر روی
.IR NUM .
.TP
.BI \-S " NUM" "\fR,\fP \-\^\-substitute\-cost=" NUM
تنظیم هزینه نویسه‌های نادرست بر روی
.IR NUM .
توجه داشته باشید که یک حذف (نویسه جاافتاده) و یک درج (نویسه اضافی) در کنار هم تشکیل یک نویسه جایگزین‌شده را می‌دهند، اما هزینه آن برابر با مجموع هزینه‌های حذف و درج خواهد بود. بنابراین، اگر هزینه جایگزینی بزرگ‌تر از مجموع هزینه‌های حذف و درج تنظیم شود، جایگزینی‌های مستقیم هرگز صورت نخواهند گرفت.
.TP
.BI \-E " NUM" "\fR,\fP \-\^\-max\-errors=" NUM
انتخاب رکوردهایی که حداکثر
.I NUM
خطا دارند.
.TP
-\fI#\fR
انتخاب رکوردهایی که حداکثر \fI#\fR خطا دارند (\fI#\fR رقمی بین 0 تا 9 است).
.SS "متفرقه:"
.TP
.BI \-d " PATTERN" "\fR,\fP \-\^\-delimiter=" PATTERN
تنظیم عبارت باقاعده جداکننده رکورد بر روی
.IR PATTERN .
متن بین دو جداکننده، پیش از نخستین جداکننده و پس از آخرین جداکننده به عنوان یک رکورد تلقی می‌شود. جداکننده پیش‌فرض رکورد، عبارت باقاعده "\\n" است؛ بنابراین به‌طور پیش‌فرض هر رکورد یک خط است.
.I PATTERN
می‌تواند هر عبارت باقاعده‌ای باشد که با رشته تهی تطابق نداشته باشد. برای نمونه، استفاده از
.B \-d
"^From "
پیام‌های نامه‌های الکترونیکی را در یک فایل با قالب Mailbox به عنوان رکورد تعریف می‌کند.
.TP
.BR \-v ", " \-\^\-invert\-match
انتخاب رکوردهای غیرمنطبق به جای رکوردهای منطبق.
.TP
.BR \-V ", " \-\^\-version
چاپ اطلاعات نسخه و خروج.
.TP
.BR \-y ", " \-\^\-nothing
هیچ کاری انجام نمی‌دهد. این گزینه صرفاً جهت سازگاری با برنامه غیرآزاد agrep وجود دارد.
.TP
.BR \-\^\-help
نمایش یک پیام راهنمای مختصر و خروج.
.SS "کنترل خروجی:"
.TP
.BR \-B ", " \-\^\-best\-match
تنها رکوردهایی با بهترین تطابق را در خروجی می‌آورد، یعنی رکوردهایی که کمترین هزینه را دارند. این ویژگی در حال حاضر با دو بار پیمایش فایل‌های ورودی پیاده‌سازی شده و هنگام خواندن از ورودی استاندارد قابل استفاده نیست.
.TP
.BR \-\^\-color ", " \-\^\-colour
برجسته‌سازی رشته‌های منطبق در خروجی با یک نشانگر رنگی. رشته رنگی از متغیر محیطی
.BI GREP_COLOR
گرفته می‌شود. رنگ پیش‌فرض قرمز است.
.TP
.BR \-c ", " \-\^\-count
تنها چاپ تعداد رکوردهای منطبق برای هر فایل ورودی، و جلوگیری از خروجی عادی.
.TP
.BR \-h ", " \-\^\-no\-filename
جلوگیری از درج نام فایل به عنوان پیشوند در خروجی هنگام جستجو در چندین فایل.
.TP
.BR \-H ", " \-\^\-with\-filename
درج نام فایل ورودی که رکورد از آن خوانده شده به عنوان پیشوند در هر رکورد خروجی.
.TP
.BR \-l ", " \-\^\-files\-with\-matches
تنها چاپ نام هر فایل ورودی که حداقل دارای یک تطابق است، و جلوگیری از خروجی عادی. پیمایش هر فایل در اولین تطابق متوقف خواهد شد.
.TP
.BI \-m " NUM" "\fR,\fP \-\^\-max\-count=" NUM
توقف پردازش هر فایل ورودی پس از
.I NUM
خط منطبق (یا غیرمنطبق در صورتی که
.B \-v
مشخص شده باشد).
مقدار منفی به عنوان بی‌نهایت تفسیر می‌شود که پیش‌فرض نیز هست.
.TP
.BR \-n ", " \-\^\-record\-number
درج شماره ترتیب هر رکورد در فایل ورودی به عنوان پیشوند در خروجی. شماره نخستین رکورد 1 است.
.TP
.BR \-q ", " \-\^\-quiet ", " \-\^\-silent
هیچ چیزی در خروجی استاندارد نمی‌نویسد. در صورت یافتن تطابق، بلافاصله با وضعیت خروج صفر خارج می‌شود.
.TP
.BR \-s ", " \-\^\-show\-cost
چاپ هزینه تطابق در خروجی.
.TP
.BR \-\^\-show\-position
درج موقعیت شروع و پایان (آفست) نخستین تطابق درون رکورد به عنوان پیشوند در هر رکورد خروجی. آفست نخستین نویسه رکورد 0 است. موقعیت پایانی به عنوان آفست نخستین نویسه پس از تطابق مشخص می‌شود.
.TP
.BR \-M ", " \-\^\-delimiter\-after
به‌طور پیش‌فرض، جداکننده رکورد نویسه خط‌جدید است و پس از رکورد منطبق در خروجی درج می‌شود. اگر از
.B \-d
استفاده شود، جداکننده رکورد پیش از رکورد منطبق در خروجی می‌آید. این گزینه باعث می‌شود که جداکننده پس از رکورد منطبق خارج شود.
.PP
در صورت عدم تعیین
.IR FILE ،
یا هنگامی که
.I FILE
برابر \- باشد، ورودی استاندارد خوانده می‌شود. اگر کمتر از دو
.I FILE
داده شده باشد،
.B \-h
فرض می‌شود، در غیر این صورت
.B \-H
پیش‌فرض خواهد بود.
.SH "خطاها (DIAGNOSTICS)"
وضعیت خروج در صورت یافتن تطابق 0، در صورت عدم تطابق 1، و در صورت بروز خطا 2 خواهد بود. اگر
.B \-E
یا \-\fI#\fR مشخص نشده باشد، تنها تطابق‌های دقیق انتخاب می‌شوند.
.PP
.I PATTERN
یک عبارت باقاعده گسترش‌یافته پوزیکس (POSIX ERE) به همراه افزونه‌های TRE است.
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها را به فهرست پستی TRE به نشانی
.BR "" < tre-general@lists.laurikari.net >
ارسال کنید.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر \(co 2002-2004 Ville Laurikari.
.br
این یک نرم‌افزار آزاد است و مطلقاً بدون هیچ‌گونه ضمانتی ارائه می‌شود. شما مجاز هستید این نرم‌افزار را تحت شرایط معینی بازتوزیع کنید؛ برای متن کامل مجوز به کد منبع مراجعه فرمایید.