نام (NAME)

yank — کپی خروجی ترمینال به کلیپ‌بورد

خلاصه دستور (SYNOPSIS)

yank [-1ilxv] [-d delim] [-g pattern] [-- command [argument ...]]

توضیحات (DESCRIPTION)

ورودی را از stdin خوانده و یک واسط انتخاب نمایش می‌دهد که امکان انتخاب یک فیلد و کپی کردن آن به کلیپ‌بورد را فراهم می‌سازد. فیلدها یا از طریق یک عبارت باقاعده با استفاده از گزینهٔ -g یا با تقسیم کردن ورودی بر اساس دنباله‌ای از جداکننده‌ها با استفاده از گزینهٔ -d شناسایی می‌شوند؛ بخش جداکننده‌ها (DELIMITERS) را ببینید.

با استفاده از کلیدهای جهت‌نما می‌توان فیلد انتخاب‌شده را جابه‌جا کرد؛ بخش دستورات (COMMANDS) را ببینید. فشردن کلید return موجب فراخوانی command و نوشتن فیلد انتخاب‌شده در stdin آن می‌شود. مقدار پیش‌فرض command برابر xsel است، اما می‌تواند هر فرمانی باشد که ورودی را روی stdin می‌پذیرد؛ بخش مثال‌ها (EXAMPLES) را ببینید.

گزینه‌ها به شرح زیر هستند:

-1: اگر تنها یک فیلد شناسایی شود، آن را انتخاب کرده و بدون نمایش واسط انتخاب، command را فراخوانی می‌کند.
-d delim: تمام نویسه‌های ورودی که در delim وجود ندارند به عنوان فیلد شناسایی خواهند شد؛ بخش جداکننده‌ها (DELIMITERS) را ببینید.
-g pattern: استفاده از pattern برای شناسایی فیلدها، که به صورت یک عبارت باقاعدهٔ تعمیم‌یافتهٔ POSIX بیان می‌شود.
-i: نادیده گرفتن تفاوت بزرگی و کوچکی حروف میان pattern و ورودی.
-l: استفاده از جداکننده‌های پیش‌فرض به جز فاصله؛ بخش جداکننده‌ها (DELIMITERS) را ببینید.
-v: نسخه را چاپ می‌کند.
-x: استفاده از صفحهٔ جایگزین (alternate screen).
-- command [argument ...]: استفاده از command به همراه صفر یا چند args به عنوان دستور yank.

دستورات (COMMANDS)

Ctrl-A | g: انتقال انتخاب به اولین فیلد.
Ctrl-C | Ctrl-D: خروج بدون فراخوانی دستور yank.
Ctrl-E | G: انتقال انتخاب به آخرین فیلد.
Ctrl-P/Ctrl-N | Left/Right | h/l: انتقال انتخاب به چپ یا راست.
Ctrl-L: تغییر وضعیت میان جداکننده فعلی و جداکننده خط، معادل با گزینهٔ -l.
Up/Down | j/k: انتقال انتخاب به خط بعدی یا قبلی.
Enter: خروج با استفاده از فیلد انتخاب‌شده.

جداکننده‌ها (DELIMITERS)

در صورتی که گزینه‌های -d و -g مشخص نشوند، نویسه‌های زیر به طور پیش‌فرض به عنوان جداکننده شناخته می‌شوند:

\f: برگه‌خور (form feed)
\n: خط جدید (new line)
\r: بازگشت به ابتدای سطر (carriage return)
\s: فاصله (space)
\t: تب افقی (horizontal tab)

در صورت استفاده از گزینهٔ -d -، فاصله به عنوان جداکننده در نظر گرفته نمی‌شود.

مثال‌ها (EXAMPLES)

کپی کلید یا مقدار یک متغیر محیطی:

$ env | yank -d =

کپی یک فیلد از یک فایل CSV:

$ yank -d \",
  <file.csv

کپی کل یک خط با استفاده از گزینهٔ -l:

$ make 2>&1 | yank
  -l

اگر stdout یک ترمینال نباشد، فیلد انتخاب‌شده در stdout نوشته شده و برنامه بدون فراخوانی دستور yank خارج می‌شود. کشتن PID انتخاب‌شده:

$ ps ux | yank -g [0-9]+ | xargs
  kill

کپی فیلد انتخاب‌شده به کلیپ‌بورد اصلی (clipboard) به جای کلیپ‌بورد پیش‌فرض primary:

$ yank — xsel -b

خطاها (DIAGNOSTICS)

The yank utility exits 0 on success, and >0 if an error occurs.

همچنین ببینید (SEE ALSO)

re_format(7)

نویسندگان (AUTHORS)

Anton Lindqvist <anton@basename.se>

هشدارها (CAVEATS)

برای شناسایی فیلدهای محصور در براکت، لازم است ‘]’ پیش از ‘[’ در آرگومان ارائه‌شده به گزینهٔ -d قرار گیرد؛ بخش re_format(7) را ببینید.