.TH "LOCALE" "1" "مه ۲۰۲۵" "man-pages" "دستورهای کاربری"
.SH "نام (NAME)"
locale \- دریافت و نمایش اطلاعات مربوط به متغیرهای محلی سامانه
.SH "خلاصه دستور (SYNOPSIS)"
\fBlocale\fP [\fIگزینه‌ها\fR]
.br
\fBlocale\fP [\fIگزینه‌ها\fR] \fB\-a\fP
.br
\fBlocale\fP [\fIگزینه‌ها\fR] \fB\-m\fP
.br
\fBlocale\fP [\fIگزینه‌ها\fR] \fIنام\fR...
.SH "توضیحات (DESCRIPTION)"
دستور \fBlocale\fR اطلاعات مربوط به پیکربندی محلی‌سازی جاری یا تمام محلی‌های در دسترس را چاپ می‌کند.
.PP
هنگامی که بدون هیچ آرگومانی فراخوانی شود،
.B locale
تنظیمات جاری محلی‌سازی را برای هر دسته‌بندی محلی (نگاه کنید به
.BR locale (5))
بر پایه تنظیمات متغیرهای محیطی که محلی‌سازی را کنترل می‌کنند (نگاه کنید به
.BR locale (7))
نمایش می‌دهد. مقادیر متغیرهایی که در محیط مقداردهی شده‌اند بدون گیومه دوتایی، و مقادیر ضمنی با گیومه دوتایی چاپ می‌شوند.
.PP
اگر هر یک از گزینه‌های
.B \-a
یا
.B \-m
(یا معادل‌های قالب طولانی آن‌ها) مشخص شوند، رفتار دستور به شرح زیر خواهد بود:
.TP
.B \-\-all\-locales
.TQ
.B \-a
نمایش فهرستی از تمام محلی‌های در دسترس.
گزینه
.B \-v
باعث می‌شود متادیتای
.B LC_IDENTIFICATION
مربوط به هر محلی نیز در خروجی گنجانده شود.
.TP
.B \-\-charmaps
.TQ
.B \-m
نمایش جدول‌های نویسه (فایل‌های توصیف مجموعه نویسه‌ها) در دسترس.
برای نمایش مجموعه نویسه‌های جاری برای محلی، از
\fBlocale \-c charmap\fR
استفاده کنید.
.PP
به دستور
.B locale
می‌توان یک یا چند آرگومان نیز ارسال کرد که نام کلیدواژه‌های محلی (برای نمونه،
.IR date_fmt ،
.IR ctype\-class\-names ،
.IR yesexpr
یا
.IR decimal_point )
یا دسته‌بندی‌های محلی (برای نمونه،
.B LC_CTYPE
یا
.BR LC_TIME )
هستند. برای هر آرگومان، خروجی به شکل زیر نمایش داده می‌شود:
.IP \[bu] 3
برای یک کلیدواژه محلی، مقدار آن کلیدواژه نمایش داده می‌شود.
.IP \[bu]
برای یک دسته‌بندی محلی، مقادیر تمام کلیدواژه‌های موجود در آن دسته‌بندی نمایش داده می‌شوند.
.PP
هنگامی که آرگومان‌ها مشخص شوند، گزینه‌های زیر معنادار و کاربردی خواهند بود:
.TP
.B \-\-category\-name
.TQ
.B \-c
برای آرگومان نام دسته‌بندی، نام دسته‌بندی محلی را در خطی جداگانه پیش از فهرست مقادیر کلیدواژه‌های آن دسته‌بندی می‌نویسد.
.IP
برای آرگومان نام کلیدواژه، نام دسته‌بندی محلی مربوط به این کلیدواژه را در خطی جداگانه پیش از مقدار کلیدواژه می‌نویسد.
.IP
این گزینه هنگام تعیین چند آرگومانِ نام، خوانایی خروجی را بهبود می‌بخشد. این گزینه می‌تواند با گزینه
.B \-k
ترکیب شود.
.TP
.B \-\-keyword\-name
.TQ
.B \-k
برای هر کلیدواژه‌ای که مقدار آن نمایش داده می‌شود، نام آن کلیدواژه را نیز اضافه می‌کند، به‌طوری که خروجی قالب زیر را خواهد داشت:
.IP
.in +4n
.EX
.IR keyword =\[dq] value \[dq]
.EE
.in
.PP
دستور
.B locale
همچنین گزینه‌های زیر را می‌شناسد:
.TP
.B \-\-verbose
.TQ
.B \-v
نمایش اطلاعات بیشتر برای برخی از ترکیب‌های گزینه‌ها و آرگومان‌های خط فرمان.
.TP
.B \-\-help
.TQ
.B \-?
نمایش خلاصه‌ای از گزینه‌ها و آرگومان‌های خط فرمان و خروج.
.TP
.B \-\-usage
نمایش پیام کاربرد کوتاه و خروج.
.TP
.B \-\-version
.TQ
.B \-V
نمایش نسخه برنامه و خروج.
.SH "فایل‌ها (FILES)"
.TP
.I /usr/lib/locale/locale\-archive
مسیر پیش‌فرض معمول برای بایگانی محلی‌ها.
.TP
.I /usr/share/i18n/locales
مسیر پیش‌فرض معمول برای فایل‌های تعریف محلی.
.SH "استانداردها (STANDARDS)"
POSIX.1-2008.
.SH "تاریخچه (HISTORY)"
POSIX.1-2001.
.SH "مثال‌ها (EXAMPLES)"
.EX
$ \fBlocale\fP
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=
.P
$ \fBlocale date_fmt\fP
%a %b %e %H:%M:%S %Z %Y
.P
$ \fBlocale \-k date_fmt\fP
date_fmt="%a %b %e %H:%M:%S %Z %Y"
.P
$ \fBlocale \-ck date_fmt\fP
LC_TIME
date_fmt="%a %b %e %H:%M:%S %Z %Y"
.P
$ \fBlocale LC_TELEPHONE\fP
+%c (%a) %l
(%a) %l
11
1
UTF\-8
.P
$ \fBlocale \-k LC_TELEPHONE\fP
tel_int_fmt="+%c (%a) %l"
tel_dom_fmt="(%a) %l"
int_select="11"
int_prefix="1"
telephone\-codeset="UTF\-8"
.EE
.PP
مثال زیر یک محلی سفارشی را از دایرکتوری
.I ./wrk
با استفاده از ابزار
.BR localedef (1)
در دایرکتوری
.I $HOME/.locale
کامپایل می‌کند، سپس نتیجه را با دستور
.BR date (1)
آزمایش کرده، و در نهایت متغیرهای محیطی
.B LOCPATH
و
.B LANG
را در فایل پروفایل شل تنظیم می‌کند تا محلی سفارشی در نشست‌های بعدی کاربر مورد استفاده قرار گیرد:
.PP
.EX
$ \fBmkdir \-p $HOME/.locale\fP
$ \fBI18NPATH=./wrk/ localedef \-f UTF\-8 \-i fi_SE $HOME/.locale/fi_SE.UTF\-8\fP
$ \fBLOCPATH=$HOME/.locale LC_ALL=fi_SE.UTF\-8 date\fP
$ \fBecho "export LOCPATH=\[rs]$HOME/.locale" >> $HOME/.bashrc\fP
$ \fBecho "export LANG=fi_SE.UTF\-8" >> $HOME/.bashrc\fP
.EE
.SH "همچنین ببینید (SEE ALSO)"
.BR localedef (1),
.BR charmap (5),
.BR locale (5),
.BR locale (7)