LOCALE(1) دستورهای کاربری LOCALE(1)

locale - دریافت و نمایش اطلاعات مربوط به متغیرهای محلی سامانه

locale [گزینه‌ها]
locale [گزینه‌ها] -a
locale [گزینه‌ها] -m
locale [گزینه‌ها] نام...

دستور locale اطلاعات مربوط به پیکربندی محلی‌سازی جاری یا تمام محلی‌های در دسترس را چاپ می‌کند.

هنگامی که بدون هیچ آرگومانی فراخوانی شود، locale تنظیمات جاری محلی‌سازی را برای هر دسته‌بندی محلی (نگاه کنید به locale(5)) بر پایه تنظیمات متغیرهای محیطی که محلی‌سازی را کنترل می‌کنند (نگاه کنید به locale(7)) نمایش می‌دهد. مقادیر متغیرهایی که در محیط مقداردهی شده‌اند بدون گیومه دوتایی، و مقادیر ضمنی با گیومه دوتایی چاپ می‌شوند.

اگر هر یک از گزینه‌های -a یا -m (یا معادل‌های قالب طولانی آن‌ها) مشخص شوند، رفتار دستور به شرح زیر خواهد بود:

نمایش فهرستی از تمام محلی‌های در دسترس. گزینه -v باعث می‌شود متادیتای LC_IDENTIFICATION مربوط به هر محلی نیز در خروجی گنجانده شود.
نمایش جدول‌های نویسه (فایل‌های توصیف مجموعه نویسه‌ها) در دسترس. برای نمایش مجموعه نویسه‌های جاری برای محلی، از locale -c charmap استفاده کنید.

به دستور locale می‌توان یک یا چند آرگومان نیز ارسال کرد که نام کلیدواژه‌های محلی (برای نمونه، date_fmt، ctype-class-names، yesexpr یا decimal_point) یا دسته‌بندی‌های محلی (برای نمونه، LC_CTYPE یا LC_TIME) هستند. برای هر آرگومان، خروجی به شکل زیر نمایش داده می‌شود:

•
برای یک کلیدواژه محلی، مقدار آن کلیدواژه نمایش داده می‌شود.
•
برای یک دسته‌بندی محلی، مقادیر تمام کلیدواژه‌های موجود در آن دسته‌بندی نمایش داده می‌شوند.

هنگامی که آرگومان‌ها مشخص شوند، گزینه‌های زیر معنادار و کاربردی خواهند بود:

برای آرگومان نام دسته‌بندی، نام دسته‌بندی محلی را در خطی جداگانه پیش از فهرست مقادیر کلیدواژه‌های آن دسته‌بندی می‌نویسد.
برای آرگومان نام کلیدواژه، نام دسته‌بندی محلی مربوط به این کلیدواژه را در خطی جداگانه پیش از مقدار کلیدواژه می‌نویسد.
این گزینه هنگام تعیین چند آرگومانِ نام، خوانایی خروجی را بهبود می‌بخشد. این گزینه می‌تواند با گزینه -k ترکیب شود.
برای هر کلیدواژه‌ای که مقدار آن نمایش داده می‌شود، نام آن کلیدواژه را نیز اضافه می‌کند، به‌طوری که خروجی قالب زیر را خواهد داشت:

keyword="value"

دستور locale همچنین گزینه‌های زیر را می‌شناسد:

نمایش اطلاعات بیشتر برای برخی از ترکیب‌های گزینه‌ها و آرگومان‌های خط فرمان.
-?
نمایش خلاصه‌ای از گزینه‌ها و آرگومان‌های خط فرمان و خروج.
نمایش پیام کاربرد کوتاه و خروج.
نمایش نسخه برنامه و خروج.

/usr/lib/locale/locale-archive
مسیر پیش‌فرض معمول برای بایگانی محلی‌ها.
/usr/share/i18n/locales
مسیر پیش‌فرض معمول برای فایل‌های تعریف محلی.

POSIX.1-2008.

POSIX.1-2001.

$ locale
LANG=en_US.UTF-8
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL=
$ locale date_fmt
%a %b %e %H:%M:%S %Z %Y
$ locale -k date_fmt
date_fmt="%a %b %e %H:%M:%S %Z %Y"
$ locale -ck date_fmt
LC_TIME
date_fmt="%a %b %e %H:%M:%S %Z %Y"
$ locale LC_TELEPHONE
+%c (%a) %l
(%a) %l
11
1
UTF-8
$ locale -k LC_TELEPHONE
tel_int_fmt="+%c (%a) %l"
tel_dom_fmt="(%a) %l"
int_select="11"
int_prefix="1"
telephone-codeset="UTF-8"

مثال زیر یک محلی سفارشی را از دایرکتوری ./wrk با استفاده از ابزار localedef(1) در دایرکتوری $HOME/.locale کامپایل می‌کند، سپس نتیجه را با دستور date(1) آزمایش کرده، و در نهایت متغیرهای محیطی LOCPATH و LANG را در فایل پروفایل شل تنظیم می‌کند تا محلی سفارشی در نشست‌های بعدی کاربر مورد استفاده قرار گیرد:

$ mkdir -p $HOME/.locale
$ I18NPATH=./wrk/ localedef -f UTF-8 -i fi_SE $HOME/.locale/fi_SE.UTF-8
$ LOCPATH=$HOME/.locale LC_ALL=fi_SE.UTF-8 date
$ echo "export LOCPATH=\$HOME/.locale" >> $HOME/.bashrc
$ echo "export LANG=fi_SE.UTF-8" >> $HOME/.bashrc

localedef(1), charmap(5), locale(5), locale(7)

مه ۲۰۲۵ man-pages