نام (NAME)

vis-clipboard — خواندن از یا نوشتن در کلیپ‌بورد سیستم

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

vis-clipboard --usable

vis-clipboard --copy [--selection selection]

vis-clipboard --paste [--selection selection]

توضیحات (DESCRIPTION)

دستور vis-clipboard ابزارهای گوناگون و ویژه‌ی هر سیستم را برای تعامل با کلیپ‌بورد سیستم در بر می‌گیرد. این ابزار بسته به پرچم داده‌شده در خط فرمان، می‌تواند به سه روش مختلف اجرا شود.

--usable: در این حالت، vis-clipboard به‌دنبال راهی برای برقراری ارتباط با کلیپ‌بورد سیستم می‌گردد. در صورت یافتن رابط، با کد خروج 0 خاتمه می‌یابد. اگر رابطی برای کلیپ‌بورد سیستم در دسترس نباشد، با کد خروج 1 خاتمه می‌یابد.
--copy: در این حالت، vis-clipboard محتوای ورودی استاندارد را می‌خواند و آن را در کلیپ‌بورد سیستم ذخیره می‌کند.
--paste: در این حالت، vis-clipboard محتوای کلیپ‌بورد سیستم را می‌خواند و آن را در خروجی استاندارد می‌نویسد.
--selection selection: انتخاب (selection) مورد استفاده را مشخص می‌کند؛ گزینه‌ها عبارتند از "primary" یا "clipboard". این گزینه در پلتفرم‌هایی با یک کلیپ‌بورد واحد، بدون اعلام خطا نادیده گرفته می‌شود.

ابزارهای کلیپ‌بورد (CLIPBOARD TOOLS)

برای تعیین این‌که از کدام کلیپ‌بورد سیستم استفاده شود، vis-clipboard این ابزارهای کلیپ‌بورد را با ترتیب زیر بررسی می‌کند:

wl-clipboard(1): Wayland (در صورت تنظیم بودن $WAYLAND_DISPLAY)
wayclip: Wayland (در صورت تنظیم بودن $WAYLAND_DISPLAY)
xclip(1): X11 (در صورت تنظیم بودن $DISPLAY)
xsel(1): X11 (در صورت تنظیم بودن $DISPLAY)
pbcopy(1) / pbpaste(1): macOS
wslclip(1): WSL (Windows Subsystem for Linux)
/dev/clipboard: Cygwin
termux-clipboard-{get,set}: Termux

وضعیت خروج (EXIT STATUS)

The vis-clipboard utility exits 0 on success, and >0 if an error occurs. هنگام اجرا با پرچم --usable ، وضعیت خروج 0 به این معنی است که یک ابزار پشتیبانی‌شده‌ی ویژه‌ی سیستم پیدا شده است، در حالی که 1 یعنی دسترسی به کلیپ‌بورد امکان‌پذیر نیست.

مثال‌ها (EXAMPLES)

بررسی این‌که آیا دسترسی به کلیپ‌بورد در دسترس است یا خیر:

if vis-clipboard --usable; then
	echo "Clipboard access available"
else
	echo "No clipboard"
fi

کپی کردن یک پیام خوش‌آمدگویی در کلیپ‌بورد:

echo "Hello, World" | vis-clipboard --copy

ارسال محتوای فعلی کلیپ‌بورد سیستم جهت ثبت و تجزیه‌وتحلیل:

vis-clipboard --paste | curl -d - https://www.nsa.gov

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

pbcopy(1), pbpaste(1), vis(1), waycopy(1), waypaste(1), wl-clipboard(1), wslclip(1), xclip(1), xsel(1)