.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.TH "GREPC" "1" "نوامبر ۲۰۲۵" "Linux man-pages" "دستورات کاربر"
.SH "نام (NAME)"
grepc \- یافتن اعلانات، تعاریف و کاربردهای شناسه در کدهای مبدأ
.SH "خلاصه دستور (SYNOPSIS)"
.B grepc
.RI [ گزینه\~ .\|.\|.\&]
.I الگو
.RI [ فایل\~ .\|.\|.\&]
.SH "توضیحات (DESCRIPTION)"
دستور \fBgrepc\fR به جستجوی اعلانات (declarations)، تعاریف (definitions) و کاربردهای شناسهها و الگوهای مشخصشده در فایلهای مبدأ برنامهنویسی بر پایه عبارات باقاعده PCRE میپردازد.
.PP
دستور
.BR grepc (1)
به جستجوی اعلانات، تعاریف یا کاربردهای
.I الگو
در هر
.I فایل
مبدأ می‌پردازد.
.P
.I الگو
یک الگوی PCRE است.
این الگو معمولاً یک شناسه (identifier) را نشان می‌دهد
و مرزهای کلمات (word boundaries) در بیشتر موارد به‌طور ضمنی به آن اضافه می‌شوند.
.P
اگر هیچ
.I فایل
ی داده نشود،
این برنامه از ورودی استاندارد می‌خواند.
در غیر این صورت،
تمامی فایل‌های مشخص‌شده را می‌خواند
و در هر پوشه یا دایرکتوری مشخص‌شده، به‌صورت بازگشتی (recursively)
و بدون دنبال کردن پیوندهای نمادین (symbolic links) به جستجو می‌پردازد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-A \~n
چاپ
.I n
سطر از متن پس از تطابق (trailing context).
.TP
.BI \-B \~n
چاپ
.I n
سطر از متن پیش از تطابق (leading context).
.TP
.BI \-C \~n
چاپ
.I n
سطر از متن پیرامون تطابق (surrounding context).
.TP
.B \-c
موارد تطابق‌یافته چاپ نمی‌شوند؛
به‌جای آن تعداد آن‌ها چاپ می‌شود.
.TP
.B \-h
از قرار دادن پیشوند نام فایل در خروجی جلوگیری می‌کند.
.TP
.B \-i
نادیده گرفتن تمایز حروف کوچک و بزرگ در
.IR الگو .
.TP
.B \-l
خروجی عادی را متوقف می‌کند؛
به‌جای آن نام هر فایل ورودی که خروجی معمولاً از آن چاپ می‌شد را چاپ می‌کند.
هر فایل فقط یک‌بار چاپ می‌شود.
.TP
.BI \-m \~n
توقف پردازش پس از یافتن
.I n
مورد تطابق.
.TP
.B \-n
پیشوند قرار دادن شماره سطر (شروع از ۱) درون فایل ورودی برای هر سطر از خروجی.
.TP
.BI \-t \~نوع
محدود کردن جستجو به یک
.I نوع
خاص از کد.
این گزینه می‌تواند چندین بار مشخص شود
تا انواع مختلفی از کد جستجو شوند.
مقادیر پذیرفته‌شده به راه‌انداز (driver) مورد استفاده برای زبان بستگی دارد.
ببینید:
.BR grepc_c (1)،
که راه‌انداز پیش‌فرض است.
.SH "نکات قابل توجه (CAVEATS)"
.SS "کرش‌ها و خرابی‌ها (Crashes)"
در برخی موارد،
فراخوانی‌های داخلی به
.BR pcre2grep (1)
ممکن است پس از مصرف بیش از حد منابع شکست بخورند.
برای حل این مشکل،
از گزینه
.B \-t
برای محدود کردن نوع کد در جستجوی خود استفاده کنید.
.SS "فایل‌های با قابلیت پرش (Seekable files)"
فایل‌های مشخص‌شده در خط فرمان
باید قابل پرش و پیمایش (seekable) بوده و امکان دو بار باز شدن را داشته باشند.
اگر نیاز به خواندن فایلی بدون قابلیت seek دارید،
آن را به ورودی استاندارد تغییر مسیر دهید.
.SH "مثال‌ها (EXAMPLES)"
.EX
.RB alx@devuan:/usr/lib/gcc$ " grepc -n alignof ." ;
\&./x86_64\-linux\-gnu/15/include/stdalign.h:33:#define alignof _Alignof
.EE
.SH "همچنین ببینید (SEE ALSO)"
.BR grepc_c (1),
.BR pcre2grep (1),
.BR pcre2syntax (3),
.BR pcre2pattern (3)