نام (NAME)

vis-open — انتخاب تعاملی یک فایل برای باز کردن

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

vis-open [-p prompt] [-f] [--] [files]

vis-open -h

توضیحات (DESCRIPTION)

دستور vis-open فهرستی از نام‌های فایل‌ها و دایرکتوری‌ها را از خط فرمان دریافت کرده و آن‌ها را در قالب یک منو برای انتخاب کاربر نمایش می‌دهد. اگر کاربر یک دایرکتوری (از جمله ..) را انتخاب کند، محتویات آن دایرکتوری در یک منوی تازه نمایش داده می‌شود. به‌محض اینکه کاربر یک نام فایل را انتخاب کند، مسیر مطلق آن در خروجی استاندارد چاپ می‌شود.

دستور vis-open از vis-menu(1) به‌عنوان رابط کاربری خود استفاده می‌کند، بنابراین برای جزئیات بیشتر به صفحهٔ راهنمای آن مراجعه کنید.

-p prompt

نمایش prompt پیش از فهرست موارد. این مقدار مستقیماً به vis-menu(1) پاس داده می‌شود.

-f

در حالت عادی، اگر تنها یک آرگومان نام فایل یا دایرکتوری به vis-open داده شود، آن را به‌طور خودکار انتخاب می‌کند (چاپ نام فایل در خروجی استاندارد، یا ارائهٔ یک منوی جدید شامل محتویات آن دایرکتوری). اگر گزینهٔ -f مشخص شود، دستور vis-open همیشه آرگومان‌های ارائه‌شده را نمایش خواهد داد، حتی اگر فقط یک مورد وجود داشته باشد.

--

اگر این نشانه پیش از اولین آرگومانِ غیرگزینه‌ای دیده شود، تمام آرگومان‌های پس از آن به‌عنوان موارد منو تلقی می‌شوند، حتی اگر در حالت معمول گزینه‌های معتبر خط فرمان باشند.

اگر پس از اولین آرگومان غیرگزینه‌ای، یا پس از یک نمونهٔ قبلی از -- قرار گیرد، به‌عنوان یک مورد از منو در نظر گرفته می‌شود.

files

نام‌های فایل‌ها و دایرکتوری‌هایی که باید به کاربر نمایش داده شوند. اگر نامی در سامانه فایل وجود نداشته باشد و کاربر آن را انتخاب کند، به‌عنوان یک فایل در نظر گرفته می‌شود.

-h

در صورت وجود، دستور vis-open خلاصه‌ای از نحوهٔ استفاده را چاپ کرده و خارج می‌شود، و سایر فلگ‌ها و آرگومان‌ها را نادیده می‌گیرد.

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

The vis-open utility exits 0 on success, and >0 if an error occurs.

به‌ویژه، همانند vis-menu(1) ، اگر کاربر از انتخاب فایل خودداری کند، دستور vis-open چیزی چاپ نکرده و وضعیت خروج خود را برابر با 1 قرار می‌دهد.

مثال‌ها (EXAMPLES)

CHOICE=$(vis-open -p "Select a file to stat")
if [ $? -gt 0 ]; then
	echo "No selection was made, or an error occurred"
else
	stat "$CHOICE"
fi

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

vis(1), vis-menu(1)

اشکالات (BUGS)

از آنجا که vis-open برای دریافت محتویات یک دایرکتوری از ls(1) استفاده می‌کند، اگر نویسه‌های کنترلی در نام فایل‌های شما وجود داشته باشد ممکن است رفتارهای غیرمنتظره‌ای رخ دهد.