.\" Man page generated from reStructuredText .\" by the Docutils 0.22.2 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "readtags" "1" "" "6.2.1" "Universal Ctags" .SH "نام (NAME)" readtags \- یافتن مدخل‌های فایل برچسب منطبق با نام‌های مشخص‌شده .SH "خلاصه دستور (SYNOPSIS)" .nf \fBreadtags\fP \-h | \-\-help \fBreadtags\fP (\-H | \-\-help\-expression) (filter|sorter|formatter) \fBreadtags\fP \-v | \-\-version \fBreadtags\fP [OPTION]... ACTION .fi .sp .SH "توضیحات (DESCRIPTION)" .sp برنامه \fBreadtags\fP مدخل‌های برچسب موجود در یک فایل برچسب را فیلتر، مرتب و چاپ می‌کند. فیلتر کردن اولیه با استفاده از \fBعملیات‌ها (actions)\fP انجام می‌شود که از طریق آن‌ها می‌توانید تمام برچسب‌های عادی، شبه‌برچسب‌ها یا برچسب‌های عادی منطبق با نامی مشخص را فهرست کنید. سپس، فیلتر کردن، مرتب‌سازی و قالب‌بندی بیشتر می‌تواند با استفاده از \fBپس‌پردازشگرها (post processors)\fP، شامل \fBعبارت‌های فیلتر (filter expressions)\fP، \fBعبارت‌های مرتب‌ساز (sorter expressions)\fP و \fBعبارت‌های قالب‌بند (formatter expressions)\fP انجام شود. .SH "عملیات‌ها (ACTIONS)" .INDENT 0.0 .TP .B \fB\-l\fP, \fB\-\-list\fP فهرست کردن برچسب‌های عادی. .TP .B \fB[\-] NAME\fP فهرست کردن برچسب‌های عادی منطبق با NAME. استفاده از \(dq\-\(dq به عنوان NAME مشخص می‌کند که آرگومان‌های پس از آن، حتی اگر با \- شروع شوند، به عنوان NAME در نظر گرفته شوند. .TP .B \fB\-D\fP, \fB\-\-list\-pseudo\-tags\fP فهرست کردن شبه‌برچسب‌ها. می‌توانید از این گزینه همراه با گزینه \fB\-Q\fP برای استخراج شبه‌برچسب‌های مشخص‌شده استفاده کنید. .UNINDENT .SH "گزینه‌ها (OPTIONS)" .SS کنترل رفتار خواندن برچسب‌ها .sp رفتار خواندن برچسب‌ها را می‌توان با استفاده از این گزینه‌ها کنترل کرد: .INDENT 0.0 .TP .B \fB\-t TAGFILE\fP, \fB\-\-tag\-file TAGFILE\fP استفاده از فایل برچسب مشخص‌شده (پیش‌فرض: \(dqtags\(dq). دادن \(dq\-\(dq به عنوان TAGFILE مشخص می‌کند که محتوای فایل برچسب از ورودی استاندارد خوانده شود. استفاده از \(dq\-\(dq می‌تواند خط فرمان را ساده‌تر کند؛ با این حال، به معنای کارایی بالاتر نیست؛ زیرا readtags داده‌ها را در یک فایل موقت ذخیره کرده و آن فایل را برای اجرای ACTION می‌خواند. .TP .B \fB\-s[0|1|2]\fP, \fB\-\-override\-sort\-detection METHOD\fP نادیده گرفتن تشخیص مرتب‌سازی فایل برچسب. مقدار METHOD می‌تواند یکی از موارد unsorted|sorted|foldcase باشد. .UNINDENT .sp عملیات NAME جستجوی دودویی را روی فایل‌های برچسب مرتب‌شده (شامل \(dqfoldcase\(dq) انجام می‌دهد که بسیار سریع‌تر از فایل‌های برچسب مرتب‌نشده است. .SS کنترل رفتار عملیات NAME .sp رفتار عملیات NAME را می‌توان با استفاده از این گزینه‌ها کنترل کرد: .INDENT 0.0 .TP .B \fB\-i\fP, \fB\-\-icase\-match\fP انجام تطبیق غیرحساس به بزرگی و کوچکی حروف در عملیات NAME. .TP .B \fB\-p\fP, \fB\-\-prefix\-match\fP انجام تطبیق پیشوند در عملیات NAME. .UNINDENT .SS کنترل خروجی .sp به‌طور پیش‌فرض، خروجی readtags تنها شامل فیلدهای name، input و pattern است. خروجی را می‌توان با استفاده از این گزینه‌ها تغییر داد: .INDENT 0.0 .TP .B \fB\-A\fP, \fB\-\-absolute\-input\fP مشابه گزینه \fB\-C\fP عمل می‌کند اما تنها از فرم مسیر مطلق استفاده می‌کند. .TP .B \fB\-C\fP, \fB\-\-canonicalize\-input\fP حل کردن \(aq..\(aq و \(aq.\(aq در فیلدهای ورودی برچسب‌های عادی. این کار نمایشی یکتا از مسیر ورودی تولید می‌کند. این گزینه فقط با فایل‌های برچسبی کار می‌کند که دارای شبه‌برچسب \fB!_TAG_PROC_CWD\fP باشند. .sp نکته: پیاده‌سازی فعلی فقط \fB!_TAG_PROC_CWD\fP را می‌پذیرد که با \fB/\fP شروع شود؛ نام دایرکتوری در ویندوز که با حرف درایو مانند \fBC:\eSomewhere\fP شروع شود قابل قبول نیست. .TP .B \fB\-d\fP, \fB\-\-debug\fP فعال کردن خروجی اشکال‌زدایی. .TP .B \fB\-E\fP, \fB\-\-escape\-output\fP اسکیپ کردن کاراکترهایی مانند تب در خروجی طبق توضیحات tags(5). .TP .B \fB\-e\fP, \fB\-\-extension\-fields\fP گنجاندن فیلدهای الحاقی در خروجی. .TP .B \fB\-n\fP, \fB\-\-line\-number\fP همچنین گنجاندن فیلد شماره خط در هنگام استفاده از گزینه \fB\-e\fP. .TP .B \fB\-P\fP, \fB\-\-with\-pseudo\-tags\fP فهرست کردن شبه‌برچسب‌ها به‌گونه‌ای که گویی گزینه \fB\-D\fP مشخص شده است، اما بدون خروج پردازش را ادامه می‌دهد. حتی اگر گزینه‌های \fB\-Q\fP و \fB\-P\fP را همزمان مشخص کنید، \fB\-Q\fP تنها بر برچسب‌های عادی اثر می‌گذارد و شبه‌برچسب‌ها را تحت تأثیر قرار نمی‌دهد. .UNINDENT .sp درباره گزینه \fB\-E\fP: برخی کاراکترها در یک فایل برچسب اسکیپ می‌شوند تا ماشین بتواند آن‌ها را بخواند؛ به عنوان مثال، اطمینان از این‌که هیچ کاراکتر تبی در فیلدهایی غیر از فیلد الگو ظاهر نشود. به‌طور پیش‌فرض، readtags آن‌ها را تبدیل می‌کند تا برای انسان خوانا باشند، اما هنگام استفاده از خروجی readtags در یک اسکریپت یا ابزار کلاینت، باید از گزینه \fB\-E\fP استفاده شود. برای بحث بیشتر در این زمینه به ctags\-client\-tools(7) مراجعه کنید. .sp درباره چاپ فیلدهای ورودی ({tagfile} در tags(5)) با گزینه \fB\-E\fP: برنامه readtags همواره فیلد ورودی را به همان صورتی که هست (عیناً در فایل برچسب) چاپ می‌کند، و هنگامی که ctags فایل برچسب را می‌نویسد، قوانین اسکیپ تنها زمانی اعمال می‌شوند که شبه‌برچسب \fBTAG_OUTPUT_MODE\fP مقدار \(dqu\-ctags\(dq و \fBTAG_OUTPUT_FILESEP\fP مقدار \(dqslash\(dq را برای فیلدهای ورودی خود داشته باشند، همان‌گونه که در ctags\-client\-tools(7) توضیح داده شده است. .SS فیلتر کردن، مرتب‌سازی و قالب‌بندی .sp فیلتر کردن، مرتب‌سازی و قالب‌بندی بیشتر روی برچسب‌های فهرست‌شده توسط عملیات‌ها با استفاده از موارد زیر انجام می‌شود: .INDENT 0.0 .TP .B \fB\-Q EXP\fP, \fB\-\-filter EXP\fP فیلتر کردن برچسب‌های فهرست‌شده توسط ACTION با EXP پیش از چاپ. .TP .B \fB\-S EXP\fP, \fB\-\-sorter EXP\fP مرتب‌سازی برچسب‌های فهرست‌شده توسط ACTION با EXP پیش از چاپ. .TP .B \fB\-F EXP\fP, \fB\-\-formatter EXP\fP قالب‌بندی برچسب‌های فهرست‌شده توسط ACTION با EXP هنگام چاپ. .UNINDENT .sp این موارد در بخش «عبارت (EXPRESSION)» بررسی شده‌اند. .SS مثال‌ها .INDENT 0.0 .IP \(bu 2 فهرست کردن تمام برچسب‌ها در \(dq/path/to/tags\(dq: .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-t /path/to/tags \-l .EE .UNINDENT .UNINDENT .IP \(bu 2 فهرست کردن تمام برچسب‌های موجود در \(dqtags\(dq که با \(dqmymethod\(dq شروع می‌شوند: .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-p \- mymethod .EE .UNINDENT .UNINDENT .IP \(bu 2 فهرست کردن تمام برچسب‌های منطبق با \(dqmymethod\(dq بدون حساسیت به بزرگی و کوچکی حروف: .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-i \- mymethod .EE .UNINDENT .UNINDENT .IP \(bu 2 فهرست کردن تمام برچسب‌هایی که با \(dqmyvar\(dq شروع می‌شوند، و چاپ تمام فیلدها (یعنی کل خط): .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-p \-ne \- myvar .EE .UNINDENT .UNINDENT .UNINDENT .SH "عبارت (EXPRESSION)" .sp برای گزینه‌های \fB\-Q\fP، \fB\-S\fP و \fB\-F\fP از عبارت‌هایی به سبک اسکیم (Scheme\-style) استفاده می‌شود. برای کسانی که با زبان اسکیم یا لیسپ آشنا نیستند، تنها کافی است موارد زیر را به خاطر بسپارند: .INDENT 0.0 .IP \(bu 2 یک فراخوانی تابع درون یک جفت پرانتز قرار می‌گیرد. نخستین مورد درون آن، نام تابع/عملگر است و موارد دیگر آرگومان‌ها هستند. .IP \(bu 2 فراخوانی‌های تابع می‌توانند تودرتو باشند. .IP \(bu 2 مقادیر ناموجود و نادرست بولی با \fB#f\fP نمایش داده می‌شوند. \fB#t\fP و تمام مقادیر دیگر درست (true) در نظر گرفته می‌شوند. .UNINDENT .sp بنابراین، \fB(+ 1 (+ 2 3))\fP به این معنی است که ابتدا ۲ و ۳ جمع شوند، سپس نتیجه با ۱ جمع شود. \fB(and \(dqstring\(dq 1 #t)\fP به معنی AND منطقی روی \fB\(dqstring\(dq\fP، \fB1\fP و \fB#t\fP است، و نتیجه درست خواهد بود چرا که هیچ \fB#f\fP وجود ندارد. .SS فیلتر کردن .sp مدخل‌های برچسبی که باعث می‌شوند عبارت فیلتر مقدار درست تولید کند، توسط readtags چاپ می‌شوند. .sp عملگرهای پایه برای فیلتر کردن عبارتند از \fBeq?\fP، \fBprefix?\fP، \fBsuffix?\fP، \fBsubstr?\fP و \fB#/PATTERN/\fP\&. فیلدهای مشترک زبان‌ها را می‌توان با استفاده از متغیرهایی که با \fB$\fP شروع می‌شوند در دسترس قرار داد؛ برای مثال، \fB$language\fP نشان‌دهنده فیلد زبان است. برای نمونه: .INDENT 0.0 .IP \(bu 2 فهرست کردن تمام برچسب‌هایی که با \(dqmyfunc\(dq در فایل‌های کد پایتون شروع می‌شوند: .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-p \-Q \(aq(eq? $language \(dqPython\(dq)\(aq \- myfunc .EE .UNINDENT .UNINDENT .UNINDENT .sp عملگرهای \fBdowncase\fP یا \fBupcase\fP را می‌توان برای انجام تطبیق بدون حساسیت به بزرگی و کوچکی حروف به کار برد: .INDENT 0.0 .IP \(bu 2 فهرست کردن تمام برچسب‌های حاوی \(dqmy\(dq، بدون حساسیت به بزرگی و کوچکی حروف: .INDENT 2.0 .INDENT 3.5 .INDENT 0.0 .INDENT 3.5 .sp .EX $ readtags \-Q \(aq(substr? (downcase $name) \(dqmy\(dq)\(aq \-l .EE .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .sp عملگرهای منطقی مانند \fBand\fP، \fBor\fP و \fBnot\fP نیز وجود دارند. مقدار یک فیلد ناموجود برابر با #f است، بنابراین می‌توانیم با فیلدهای ناموجود به این شکل برخورد کنیم: .INDENT 0.0 .IP \(bu 2 فهرست کردن تمام برچسب‌های حاوی \(dqimpl\(dq در فایل‌های کد پایتون، به همراه مجاز شمردن ناموجود بودن فیلد \fBlanguage:\fP: .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-Q \(aq(and (substr? $name \(dqimpl\(dq)\e (or (not $language)\e (eq? $language \(dqPython\(dq)))\(aq \-l .EE .UNINDENT .UNINDENT .UNINDENT .sp الگوی \fB#/PATTERN/\fP برای شرایطی است که مسندهای رشته‌ای (\fBprefix?\fP، \fBsuffix?\fP و \fBsubstr?\fP) کافی نیستند. می‌توانید از «عبارت باقاعده تعمیم‌یافته پوزیکس (POSIX extended regular expression)» به عنوان PATTERN استفاده کنید. .INDENT 0.0 .IP \(bu 2 فهرست کردن تمام برچسب‌هایی که از کلاس \(dqA\(dq ارث‌بری می‌کنند: .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-Q \(aq(#/(^|,) ?A(,|$)/ $inherits)\(aq \-l .EE .UNINDENT .UNINDENT .UNINDENT .sp در اینجا \fB$inherits\fP فهرستی از کلاس‌ها با جداکننده کاما مانند \(dqA,B,C\(dq، \(dqP, A, Q\(dq، یا فقط \(dqA\(dq است. توجه کنید که این فیلتر هم در حالتی که بعد از هر کاما فاصله وجود داشته باشد و هم در حالتی که فاصله نباشد، کار می‌کند. .sp تطبیق غیرحساس به بزرگی و کوچکی حروف را می‌توان با \fB#/PATTERN/i\fP انجام داد: .INDENT 0.0 .IP \(bu 2 فهرست کردن تمام برچسب‌هایی که از کلاس \(dqA\(dq یا \(dqa\(dq ارث‌بری می‌کنند: .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-Q \(aq(#/(^|,) ?A(,|$)/i $inherits)\(aq \-l .EE .UNINDENT .UNINDENT .UNINDENT .sp برای گنجاندن \(dq/\(dq در یک الگو، پیشوند \fB\e\fP را به \(dq/\(dq اضافه کنید. .sp نکته: الگوی عبارت باقاعده بالا برای بررسی وراثت، صرفاً مثالی برای نشان دادن نحوه استفاده از عبارت \fB#/PATTERN/\fP است. تولیدکنندگان فایل‌های برچسب هیچ توافقی بر سر قالب \fBinherits:\fP ندارند؛ برای مثال در این باره که آیا بعد از کاما باید فاصله باشد یا خیر. حتی تجزیه‌کننده‌های موجود در ctags نیز توافقی در این زمینه ندارند. توجه به قالب فیلد \fBinherits:\fP در زبان‌های خاص برای چنین پرس‌وجوهایی ضروری است. .sp عبارت‌های \fB#/PATTERN/\fP و \fB#/PATTERN/i\fP برای استفاده تعاملی در نظر گرفته شده‌اند. برنامه readtags همچنین نام مستعار \fBstring\->regexp\fP را ارائه می‌دهد، بنابراین \fB#/PATTERN/\fP برابر با \fB(string\->regexp \(dqPATTERN\(dq)\fP است، و \fB#/PATTERN/i\fP برابر با \fB(string\->regexp \(dqPATTERN\(dq :case\-fold #t)\fP\&. تابع \fBstring\->regexp\fP برای گنجاندن \(dq/\(dq در یک الگو نیازی به پیشوند \fB\e\fP ندارد. \fBstring\->regexp\fP می‌تواند ساخت عبارت را برای ابزارهای کلاینت ساده‌تر کند. همچنین برای ساخت عبارت‌ها در ابزار خود به ctags\-client\-tools(7) مراجعه کنید. .sp اکنون فیلدهای ناموجود را در نظر بگیریم. ممکن است فایل برچسب دارای مدخل‌هایی باشد که فیلد \fBinherits:\fP را ندارند. در این حالت \fB$inherits\fP برابر با #f است و تطبیق عبارت باقاعده باعث بروز خطا می‌شود، چرا که عملگرهای رشته‌ای تنها برای رشته‌ها کار می‌کنند. برای جلوگیری از این مشکل: .INDENT 0.0 .IP \(bu 2 فهرست کردن ایمن تمام برچسب‌هایی که از کلاس \(dqA\(dq ارث‌بری می‌کنند: .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-Q \(aq(and $inherits (#/(^|,) ?A(,|$)/ $inherits))\(aq \-l .EE .UNINDENT .UNINDENT .UNINDENT .sp این کار تضمین می‌کند که ابتدا \fB$inherits\fP ناموجود نباشد و سپس آن را با عبارت باقاعده تطبیق دهد. .sp گاهی مایلید برچسب‌هایی را نگه دارید که فیلد مورد نظر در آن‌ها \fIناموجود\fP است. برای نمونه، می‌خواهید برچسب‌های مرجع را که توسط فیلد \fBextras:\fP مشخص شده‌اند کنار بگذارید؛ در این صورت می‌خواهید برچسب‌هایی را که فیلد \fBextras:\fP ندارند حفظ کنید، زیرا آن‌ها نیز برچسب مرجع نیستند. در ادامه نحوه انجام این کار آمده است: .INDENT 0.0 .IP \(bu 2 فهرست کردن تمام برچسب‌ها به جز برچسب‌های مرجع: .INDENT 2.0 .INDENT 3.5 .sp .EX $ readtags \-Q \(aq(or (not $extras) (#/(^|,) ?reference(,|$)/ $extras))\(aq \-l .EE .UNINDENT .UNINDENT .UNINDENT .sp توجه داشته باشید که عبارت \fB(not $extras)\fP هنگامی که \fB$extras\fP ناموجود باشد مقدار \fB#t\fP تولید می‌کند، بنابراین کل عبارت \fBor\fP مقدار \fB#t\fP تولید خواهد کرد. .sp ترکیب \fBctags \-o \-\fP و \fBreadtags \-t \-\fP برای بررسی یک فایل منبع، تا زمانی که فایل منبع به اندازه کافی کوتاه باشد، بسیار کاربردی است. .INDENT 0.0 .IP \(bu 2 فهرست کردن تمام توابع بزرگ (بیش از ۱۰۰ خط) در یک فایل: .INDENT 2.0 .INDENT 3.5 .sp .EX $ ctags \-o \- \-\-fields=+neKz input.c \e | ./readtags \-t \- \-en \e \-Q \(aq(and (eq? $kind \(dqfunction\(dq) $end $line (> (\- $end $line) 100))\(aq \e \-l .EE .UNINDENT .UNINDENT .IP \(bu 2 فهرست کردن تمام برچسب‌هایی که شامل خط ۸۰ در یک فایل هستند: .INDENT 2.0 .INDENT 3.5 .sp .EX $ ctags \-o \- \-\-fields=+neKz input.c \e | readtags \-t \- \-ne \e \-Q \(aq(and $line (or (eq? $line 80) (and $end (< $line 80) (< 80 $end))))\(aq \e \-l .EE .UNINDENT .UNINDENT .UNINDENT .sp دستور \(dqreadtags \-H filter\(dq را برای آگاهی از تمام توابع و متغیرهای معتبر اجرا کنید. .SS مرتب‌سازی .sp هنگام مرتب‌سازی، عبارت مرتب‌ساز روی دو مدخل برچسب ارزیابی می‌شود تا تعیین کند کدام‌یک باید پیش از دیگری قرار گیرد، تا زمانی که ترتیب تمام مدخل‌های برچسب مشخص شود. .sp در یک عبارت مرتب‌ساز، از \fB$\fP و \fB&\fP برای دسترسی به فیلدهای دو مدخل برچسب استفاده می‌شود، و بیایید آن‌ها را .BR $\-entry و .BR &\-entry بنامیم. عبارت مرتب‌ساز باید مقداری برابر با \-1، 0 یا 1 داشته باشد. مقدار \-1 بدین معناست که .BR $\-entry باید بالاتر از .BR &\-entry قرار گیرد، 1 به معنای عکس آن است، و 0 ترتیب آن‌ها را در خروجی نامعین می‌سازد. .sp عملگر اصلی مرتب‌سازی \fB<>\fP است. این عملگر برای مقایسه دو رشته یا دو عدد استفاده می‌شود (اعداد مربوط به فیلدهای \fBline:\fP یا \fBend:\fP هستند). در \fB(<> a b)\fP، اگر \fBa\fP < \fBb\fP باشد، نتیجه \-1 است؛ \fBa\fP > \fBb\fP مقدار 1 را تولید می‌کند، و \fBa\fP = \fBb\fP مقدار 0 تولید می‌کند. رشته‌ها با استفاده از تابع \fBstrcmp\fP مقایسه می‌شوند؛ strcmp(3) را ببینید. .sp به عنوان مثال، مرتب‌سازی بر اساس نام‌ها، و قرار دادن مواردی که کوتاه‌ترند یا از نظر الفبایی کوچک‌تر هستند پیش از سایرین: .INDENT 0.0 .INDENT 3.5 .sp .EX $ readtags \-S \(aq(<> $name &name)\(aq \-l .EE .UNINDENT .UNINDENT .sp این عبارت به این صورت خوانده می‌شود: «اگر نام برچسب در .BR $\-entry کوچک‌تر باشد، قبل از .BR &\-entry قرار می‌گیرد». .sp عملگر \fB\fP برای زنجیره‌بندی چندین عبارت به کار می‌رود تا زمانی که یکی از آن‌ها مقدار \-1 یا 1 بازگرداند. برای مثال، مرتب‌سازی بر اساس نام فایل‌های ورودی، و سپس شماره خطوط در صورت وجود در یک فایل یکسان: .INDENT 0.0 .INDENT 3.5 .sp .EX $ readtags \-S \(aq( (<> $input &input) (<> $line &line))\(aq \-l .EE .UNINDENT .UNINDENT .sp عملگر \fB*\-\fP برای معکوس کردن نتیجه مقایسه استفاده می‌شود؛ یعنی \fB(*\- (<> a b))\fP همانند \fB(<> b a)\fP است. .sp عبارت‌های فیلتر را می‌توان در عبارت‌های مرتب‌ساز نیز به کار برد. روش کار به این صورت است که از \fBif\fP برای تولید اعداد صحیحی استفاده می‌شود که می‌توان آن‌ها را بر اساس فیلتر مقایسه کرد، مانند: .INDENT 0.0 .INDENT 3.5 .sp .EX (<> (if filter\-expr\-on\-$\-entry \-1 1) (if filter\-expr\-on\-&\-entry \-1 1)) .EE .UNINDENT .UNINDENT .sp بنابراین اگر .BR $\-entry با فیلتر مطابقت داشته باشد، در حالی که .BR &\-entry مطابقت نداشته باشد، همانند \fB(<> \-1 1)\fP خواهد بود که مقدار \fB\-1\fP را تولید می‌کند. .sp برای مثال، می‌خواهیم برچسب‌هایی از نوع \(dqfile\(dq را در زیر سایر برچسب‌ها قرار دهیم؛ در این صورت مرتب‌ساز به شکل زیر خواهد بود: .INDENT 0.0 .INDENT 3.5 .sp .EX (<> (if (eq? $kind \(dqfile\(dq) 1 \-1) (if (eq? &kind \(dqfile\(dq) 1 \-1)) .EE .UNINDENT .UNINDENT .sp بررسی سریع به ما نشان می‌دهد: اگر .BR $\-entry از نوع \(dqfile\(dq باشد و .BR &\-entry نباشد، مرتب‌ساز به صورت \fB(<> 1 \-1)\fP درمی‌آید که مقدار \fB1\fP تولید می‌کند، در نتیجه .BR $\-entry در زیر .BR &\-entry قرار می‌گیرد که دقیقاً همان خواسته ما است. .SS قالب‌بندی .sp یک عبارت قالب‌بند تعیین می‌کند که readtags چگونه مدخل‌های برچسب را چاپ کند. .sp یک عبارت قالب‌بند ممکن است یک رشته، یک مقدار بولی، یک عدد صحیح، یا یک فهرست تولید کند. readtags رشته و عدد صحیح تولیدشده را همان‌گونه که هستند چاپ می‌کند. برای \fB#f\fP چیزی چاپ نمی‌کند و برای \fB#t\fP یک خط جدید چاپ می‌کند. .sp یک فهرست می‌تواند شامل هر تعداد رشته، مقادیر بولی، اعداد صحیح، و/یا فهرست‌ها باشد. readtags عناصر یک فهرست را به‌صورت ترتیبی و بازگشتی چاپ می‌کند. .sp تمام عملگرهای مربوط به فیلتر کردن در عبارت‌های قالب‌بند نیز در دسترس هستند. علاوه بر این عملگرها، \fBlist\fP نیز در عبارت‌های قالب‌بند در دسترس است. همان‌طور که از نام آن مشخص است، \fBlist\fP برای ایجاد یک فهرست به کار می‌رود. \fBlist\fP فهرستی شامل آرگومان‌های داده‌شده به عملگر ایجاد می‌کند؛ برای نمونه، عبارت زیر فهرستی شامل \fB1\fP، \fB#f\fP و \fB\(dqhello\(dq\fP می‌سازد: .INDENT 0.0 .INDENT 3.5 .sp .EX (list 1 #f \(dqhello\(dq) .EE .UNINDENT .UNINDENT .sp نکته: برخلاف لیسپ واقعی، ساختارهای نقل‌قول معکوس (backquote) در دسترس نیستند. .sp برای نشان دادن چند مثال، فایل برچسب زیر (\fBoutput.tags\fP) به عنوان ورودی برای readtags فرض شده است: .INDENT 0.0 .INDENT 3.5 .sp .EX M input.c 4;\(dq macro file: N input.c 3;\(dq macro file: bar input.c 11;\(dq f typeref:typename:void file: signature:(char ** argv,int * r) foo input.c 6;\(dq f typeref:typename:int file: signature:(int v) main input.c 16;\(dq f typeref:typename:int signature:(int argc,char ** argv) .EE .UNINDENT .UNINDENT .sp مثالی برای چاپ فقط نام توابع: .INDENT 0.0 .INDENT 3.5 .sp .EX $ readtags \-t output.tags \-Q \(aq(eq? $kind \(dqfunction\(dq)\(aq \-F \(aq(list $name #t)\(aq \-l bar foo main .EE .UNINDENT .UNINDENT .sp انجام همان کار تنها با یک عبارت قالب‌بند: .INDENT 0.0 .INDENT 3.5 .sp .EX $ readtags \-t output.tags \-F \(aq(if (eq? $kind \(dqfunction\(dq) (list $name #t) #f)\(aq \-l bar foo main .EE .UNINDENT .UNINDENT .sp تولید اعلان‌ها (declarations) برای توابع: .INDENT 0.0 .INDENT 3.5 .sp .EX $ readtags \-t output.tags \-F \e \(aq(if (eq? $kind \(dqfunction\(dq) (list (if $file \(dqstatic \(dq #f) $typeref\-name \(dq \(dq $name $signature \(dq;\(dq #t) #f)\(aq \-l static void bar(char ** argv,int * r); static int foo(int v); int main(int argc,char ** argv); .EE .UNINDENT .UNINDENT .SS بررسی رفتار عبارت‌ها .sp عملگر \fIprint\fP را می‌توان برای چاپ مقدار یک عبارت استفاده کرد. برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX $ readtags \-Q \(aq(print $name)\(aq \-l .EE .UNINDENT .UNINDENT .sp نام هر مدخل برچسب را قبل از آن چاپ می‌کند. از آنجا که مقدار بازگشتی \fBprint\fP برابر با #f نیست، تمام مدخل‌های برچسب چاپ می‌شوند. ما می‌توانیم با استفاده از عملگرهای \fBbegin\fP یا \fBbegin0\fP این مورد را کنترل کنیم. \fBbegin\fP مقدار آخرین آرگومان خود را برمی‌گرداند، و \fBbegin0\fP مقدار نخستین آرگومان خود را برمی‌گرداند. برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX $ readtags \-Q \(aq(begin0 #f (print (prefix? \(dqctags\(dq \(dqct\(dq)))\(aq \-l .EE .UNINDENT .UNINDENT .sp تعدادی \(dq#t\(dq چاپ می‌کند (بسته به این‌که چه تعداد خط در فایل برچسب‌ها وجود دارد)، و خود مدخل‌های اصلی برچسب چاپ نمی‌شوند. .SH "همچنین ببینید (SEE ALSO)" .sp برای جزئیات قالب فایل برچسب‌ها tags(5) را ببینید. .sp برای نکاتی در خصوص نوشتن ابزاری که از فایل برچسب‌ها استفاده می‌کند ctags\-client\-tools(7) را ببینید. .sp وب‌سایت رسمی Universal Ctags در: .sp \% .sp مخزن گیت برای کتابخانه استفاده‌شده در دستور readtags: .sp \% .SH "سازندگان و تقدیرها (CREDITS)" .sp پروژه Universal Ctags \% .sp دارن هیبرت (Darren Hiebert) <\%> \% .sp دستور readtags و libreadtags که در پروژه Universal Ctags نگهداری می‌شوند برگرفته از readtags.c و readtags.h هستند که در \% توسعه یافته‌اند. .\" End of generated man page.