.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH NIMGREP "1" "April 2026" "nimgrep 2.2.10" "دستورات کاربر"
.SH "نام (NAME)"
nimgrep \- ابزار جستجو و جایگزینی مبتنی بر نیم
.SH "توضیحات (DESCRIPTION)"
nimgrep \- ابزار جستجو و جایگزینی Nim Grep، نسخه 2.0.0
.IP
(c) 2012\-2020 Andreas Rumpf
.PP
نحوه استفاده:
.PP
* برای جستجو:
.IP
nimgrep [options] PATTERN [(FILE/DIRECTORY)*/\-]
.PP
* برای جایگزینی:
.IP
nimgrep [options] PATTERN \fB\-\-replace\fR REPLACEMENT (FILE/DIRECTORY)*/\-
.PP
* برای فهرست کردن نام فایل‌ها:
.IP
nimgrep [options] \fB\-\-filenames\fR [PATTERN] [(FILE/DIRECTORY)*]
.PP
آرگومان‌های موضعی، از چپ به راست:
1) PATTERN یا Regex (پیش‌فرض) است یا اگر `\-\-peg` مشخص شود، Peg است.
.IP
هنگام تعیین `\-\-stdin`، از PATTERN و REPLACEMENT باید صرف‌نظر شود.
.PP
2) آرگومان REPLACEMENT از نشانه‌گذاری‌های `$1` و `$#` برای گروه‌های گرفته‌شده در PATTERN پشتیبانی می‌کند.
.IP
\&.. خطر:: حالت `\-\-replace` درخواست تأیید **نمی‌کند**
.IP
مگر آنکه `\-\-confirm` مشخص شده باشد!
.PP
3) آرگومان‌های پایانی، فهرستی از مسیرها (FILE/DIRECTORY) یا یک علامت منفی مستقل `\-` یا نامشخص (خالی) هستند:
.IP
* در صورت خالی بودن، دایرکتوری جاری `.` در نظر گرفته می‌شود (نه با `\-\-replace`)
.IP
\&.. توجه:: بنابراین اگر هیچ FILE/DIRECTORY/`\-` مشخص نشود، nimgrep
.IP
پایپ را **نمی‌خواند**، بلکه فایل‌ها را در دایرکتوری جاری جستجو می‌کند!
.IP
* `\-`: بافر یک‌بار از ورودی استاندارد (stdin) خوانده می‌شود: ورودی پایپ یا ترمینال؛
.IP
در حالت `\-\-replace` نتیجه به stdout هدایت می‌شود؛
با `\-\-stdin`، `\-\-filenames` یا `\-\-confirm` سازگار نیست
.IP
برای هر DIRECTORY داده‌شده، nimgrep تنها فایل‌های مستقیم آن را بدون پیمایش زیردایرکتوری‌ها جستجو می‌کند، مگر اینکه `\-\-recursive` مشخص شده باشد.
.PP
در حالت جایگزینی، برای جلوگیری از آسیب احتمالی، هر ۳ آرگومان موضعی الزامی هستند.
.SH "گزینه‌ها (OPTIONS)"
.SS "* حالت عملکرد (Mode of operation):"
.TP
\fB\-\-find\fR, \fB\-f\fR
یافتن PATTERN (پیش‌فرض)
.TP
\fB\-\-replace\fR, \-!
جایگزینی PATTERN با REPLACEMENT و بازنویسی فایل‌ها
.TP
\fB\-\-confirm\fR
تأیید هر رخداد/جایگزینی؛ امکان انصراف در هر زمان بدون تغییر فایل وجود دارد
.TP
\fB\-\-filenames\fR
صرفاً فهرست کردن نام فایل‌ها. یک PATTERN برای یافتن آن در نام فایل‌ها (نه در محتوای فایل) ارائه دهید یا با الگوی خالی اجرا کنید تا تمام فایل‌ها فهرست شوند:
.TP
nimgrep \fB\-\-filenames\fR
# در دایرکتوری جاری
.TP
nimgrep \fB\-\-filenames\fR "" DIRECTORY
# توجه: الگوی خالی "" تمام فایل‌های موجود در DIRECTORY را فهرست می‌کند
.SS "* تفسیر الگوها (Interpret patterns):"
.TP
\fB\-\-peg\fR
الگوهای PATTERN و PAT از نوع Peg هستند
.TP
\fB\-\-re\fR
الگوهای PATTERN و PAT عبارات باقاعده (Regex) هستند (پیش‌فرض)
.TP
\fB\-\-rex\fR, \fB\-x\fR
استفاده از نحو گسترش‌یافته (extended) برای عبارت باقاعده به طوری که فاصله‌های خالی نادیده گرفته شوند
.TP
\fB\-\-word\fR, \fB\-w\fR
تطابق‌ها باید دارای مرز کلمه باشند (برای Peg دارای اشکال است!)
.TP
\fB\-\-ignoreCase\fR, \fB\-i\fR
عدم حساسیت به بزرگی و کوچکی حروف در PATTERN و PAT
.TP
\fB\-\-ignoreStyle\fR, \fB\-y\fR
عدم حساسیت به سبک نگارش در PATTERN و PAT
.IP
\&.. توجه:: PATTERN و الگوهای PAT (گزینه‌های دیگر را در زیر ببینید) همگی هم‌زمان یا Regex یا Peg هستند و گزینه‌های `\-\-rex`، `\-\-word`، `\-\-ignoreCase` و `\-\-ignoreStyle` بر تمام آن‌ها اعمال می‌شوند.
.SS "* پیمایش فایل‌سیستم (File system walk):"
.TP
\fB\-\-recursive\fR, \fB\-r\fR
پردازش بازگشتی دایرکتوری‌ها
.TP
\fB\-\-follow\fR
دنبال کردن تمام پیوندهای نمادین هنگام پردازش بازگشتی
.TP
\fB\-\-sortTime\fR, \fB\-s[\fR:asc|desc]
مرتب‌سازی فایل‌ها بر اساس زمان آخرین تغییر (پیش‌فرض: خاموش):
صعودی (فایل‌های جدیدتر در انتها می‌آیند) یا نزولی
.PP
* فیلتر کردن فایل‌ها (بر مبنای مسیرهای فایل‌سیستم):
.IP
\&.. نکته:: به جای `not` می‌توانید صرفاً `n` را برای گزینه‌های منفی زیر تایپ کنید.
.TP
\fB\-\-ex[tensions]\fR:EX1|EX2|...
تنها جستجوی فایل‌های دارای پسوند(های) داده‌شده؛ مقدار خالی (`\-\-ex`) به معنی فایل‌های فاقد پسوند است
.TP
\fB\-\-notex[tensions]\fR:EX1|EX2|...
مستثنی کردن فایل‌های دارای پسوند(های) مشخص‌شده؛ استفاده از مقدار خالی برای نادیده گرفتن فایل‌های بدون پسوند (مانند برخی فایل‌های باینری)
.TP
\fB\-\-fi[lename]\fR:PAT
تنها جستجوی فایل‌هایی که نام آن‌ها با الگوی PAT تطابق دارد
.TP
\fB\-\-notfi[lename]\fR:PAT
نادیده گرفتن فایل‌هایی که نام آن‌ها با الگوی PAT تطابق دارد
.TP
\fB\-\-di[rname]\fR:PAT
انتخاب فایل‌هایی که در مسیر آن‌ها نام دایرکتوری با الگوی PAT مطابقت دارد
.TP
\fB\-\-notdi[rname]\fR:PAT
عدم ورود به دایرکتوری‌هایی که نام آن‌ها (نه کل مسیر) با الگوی PAT مطابقت دارد
.TP
\fB\-\-dirp[ath]\fR:PAT
تنها انتخاب فایل‌هایی که کل مسیر نسبی دایرکتوری آن‌ها با الگوی PAT تطابق دارد
.TP
\fB\-\-notdirp[ath]\fR:PAT
نادیده گرفتن فایل‌هایی که کل مسیر نسبی دایرکتوری آن‌ها با الگوی PAT تطابق دارد
.SS "* فیلتر کردن فایل‌ها (بر مبنای محتوای فایل):"
.TP
\fB\-\-inF[ile]\fR:PAT
انتخاب فایل‌های حاوی یک تطابق از PAT (نمایش داده نمی‌شود)
.TP
\fB\-\-notinF[ile]\fR:PAT
نادیده گرفتن فایل‌های حاوی یک تطابق از PAT
.TP
\fB\-\-bin\fR:on|off|only
پردازش فایل‌های باینری؟ (تشخیص با 0\e در ۱ کیلوبایت اول بایت‌ها)
(پیش‌فرض: on \- رفتار یکسان با فایل‌های باینری و متنی)
.TP
\fB\-\-text\fR, \fB\-t\fR
تنها پردازش فایل‌های متنی، معادل `\-\-bin:off`
.SS "* فیلتر کردن تطابق‌ها:"
.TP
\fB\-\-inC[ontext]\fR:PAT
تنها انتخاب تطابق‌هایی که حاوی یک تطابق از PAT در بافت متنی پیرامون خود هستند (چندخطی با `\-c`، `\-a`، `\-b`)
.TP
\fB\-\-notinC[ontext]\fR:PAT
نادیده گرفتن تطابق‌هایی که فاقد تطابق PAT در بافت متنی پیرامون خود هستند
.SS "* نمایش نتایج (Represent results):"
.TP
\fB\-\-nocolor\fR
ارائه خروجی بدون هیچ‌گونه رنگ
.TP
\fB\-\-color[\fR:on]
اعمال اجباری رنگ حتی در صورت هدایت خروجی (پیش‌فرض: خودکار)
.TP
\fB\-\-colorTheme\fR:THEME
انتخاب THEME رنگی از میان `simple` (پیش‌فرض)،
`bnw` (سیاه و سفید)، `ack`، یا `gnu` (ابزار GNU grep)
.TP
\fB\-\-count\fR
تنها چاپ تعداد تطابق‌ها برای فایل‌های منطبق‌شده
.TP
\fB\-\-context\fR:N, \fB\-c\fR:N
چاپ N خط از بافت متنی پیش از هر تطابق و
N خط از بافت متنی پس از آن (مقدار پیش‌فرض N: 0)
.TP
\fB\-\-afterContext\fR:N, \fB\-a\fR:N
چاپ N خط از بافت متنی پس از هر تطابق
.TP
\fB\-\-beforeContext\fR:N, \fB\-b\fR:N
چاپ N خط از بافت متنی پیش از هر تطابق
.TP
\fB\-\-group\fR, \fB\-g\fR
گروه‌بندی تطابق‌ها بر پایه فایل
.TP
\fB\-\-newLine\fR, \fB\-l\fR
نمایش هر خط منطبق با شروع از یک خط جدید
.TP
\fB\-\-cols[\fR:N]
محدود کردن حداکثر ستون‌ها/عرض خطوط خروجی نمایش داده شده از فایل‌ها به N کاراکتر، و برش سرریزها (پیش‌فرض: خاموش)
.TP
\fB\-\-cols\fR:auto, \-%
محاسبه تعداد ستون‌ها بر اساس عرض ترمینال برای هر خط
.TP
\fB\-\-onlyAscii\fR, \-@
تنها نمایش کاراکترهای اسکی لاتین قابل چاپ 0x20\-0x7E
جایگزینی‌ها: 0 \-> ^@, 1 \-> ^A, ... 0x1F \-> ^_,
.IP
0x7F \-> '7F, ..., 0xFF \-> 'FF
.SS "* متفرقه (Miscellaneous):"
.TP
\fB\-\-threads\fR:N, \fB\-j\fR:N
افزایش سرعت جستجو با N کارگر پردازشی (worker) اضافی (پیش‌فرض: 0، خاموش)
.TP
\fB\-\-stdin\fR
خواندن PATTERN از ورودی استاندارد (stdin) برای پرهیز از قوانین نقل‌قول گیج‌کننده شل و در صورت تعیین `\-\-replace`، خواندن REPLACEMENT
.TP
\fB\-\-verbose\fR
نمایش با جزئیات کامل: فهرست کردن تمامی فایل‌های پردازش‌شده
.TP
\fB\-\-help\fR, \fB\-h\fR
نمایش این راهنما
.TP
\fB\-\-version\fR, \fB\-v\fR
نمایش نسخه