LOCALE(5)

فایلهای پیکربندی

LOCALE(5)

نام (NAME)

locale - ساختار و قالب فایل تعریف اطلاعات متغیرهای محلی

توضیحات (DESCRIPTION)

فایل تعریف locale شامل جدولها و اطلاعاتی است که نحوه قالببندی اعداد، تاریخ، زمان، واحد پول و دستهبندی کاراکترها را برای یک زبان یا منطقه جغرافیایی مشخص میکند.

فایل تعریف locale شامل تمام اطلاعاتی است که دستور localedef(1) برای تبدیل آن به پایگاه‌داده باینری متغیرهای محلی نیاز دارد.

فایل‌های تعریف از بخش‌هایی تشکیل شده‌اند که هر یک از آن‌ها یک دسته‌بندی محلی را با جزئیات توصیف می‌کند. برای جزئیات بیشتر درباره این دسته‌بندی‌ها به locale(7) مراجعه کنید.

نحو (Syntax)

فایل تعریف متغیر محلی با یک سرآیند آغاز می‌شود که می‌تواند شامل کلمات کلیدی زیر باشد:

escape_char: به همراه نویسه‌ای می‌آید که باید به عنوان نویسه گریز (escape-character) برای ادامه فایل به کار رود تا نویسه‌هایی را مشخص کند که باید به صورت خاص تفسیر شوند. مقدار پیش‌فرض آن ممیز وارونه (\) است.
comment_char: به همراه نویسه‌ای می‌آید که به عنوان نویسه یادداشت (کامنت) برای ادامه فایل استفاده خواهد شد. مقدار پیش‌فرض آن علامت هش (#) است.

تعریف متغیر محلی برای هر دسته‌بندی محلی یک بخش دارد. هر بخش را می‌توان از یک متغیر محلی موجود دیگر کپی کرد یا از ابتدا تعریف نمود. اگر دسته‌بندی باید کپی شود، تنها کلمه کلیدی معتبر در تعریف، copy است که به دنبال آن نام متغیر محلی مورد نظر برای کپی داخل علامت نقل‌قول دوتایی قرار می‌گیرد. استثناهای این قاعده عبارتند از LC_COLLATE و LC_CTYPE که در آن‌ها عبارت copy می‌تواند با قوانین اختصاصی متغیر محلی و بازتعریف‌های انتخابی همراه شود.

هنگام تعریف یک متغیر محلی یا یک دسته‌بندی از پایه، باید از یکی از فایل‌های تعریف متغیر محلی موجود در سیستم به عنوان الگو و مرجع استفاده شود تا از قراردادهای رایج glibc پیروی گردد.

بخش‌های دسته‌بندی محلی (Locale category sections)

دسته‌بندی‌های زیر توسط استاندارد POSIX تعریف شده‌اند:

•: LC_CTYPE
•: LC_COLLATE
•: LC_MESSAGES
•: LC_MONETARY
•: LC_NUMERIC
•: LC_TIME

علاوه بر این، از نسخه glibc 2.2 به بعد، کتابخانه GNU C از دسته‌بندی‌های غیراستاندارد زیر نیز پشتیبانی می‌کند:

•: LC_ADDRESS
•: LC_IDENTIFICATION
•: LC_MEASUREMENT
•: LC_NAME
•: LC_PAPER
•: LC_TELEPHONE

برای توضیحات دقیق‌تر درباره هر یک از این دسته‌بندی‌ها به locale(7) مراجعه کنید.

LC_ADDRESS

تعریف با عبارت LC_ADDRESS در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

postal_fmt: به همراه رشته‌ای شامل توصیف‌گرهای فیلد که قالب نشانی‌های پستی را در این متغیر محلی مشخص می‌کند. توصیف‌گرهای زیر شناخته شده هستند:

%n: نام شخص، که احتمالاً با کلمه کلیدی name_fmt از دسته LC_NAME ساخته شده است (از glibc 2.24).
%a: از طریق شخص، یا نام سازمان (تحویل به/مراقبت).
%f: نام شرکت یا بنگاه تجاری.
%d: نام بخش یا دپارتمان.
%b: نام ساختمان.
%s: نام خیابان یا بلوک (مانند نشانی‌های ژاپنی).
%h: شماره یا مشخصه پلاک خانه.
%N: در صورت خالی نبودن مقدار توصیف‌گر پیشین، یک پایان خط (سطر جدید) درج می‌کند؛ در غیر این صورت نادیده گرفته می‌شود.
%t: در صورت خالی نبودن مقدار توصیف‌گر پیشین، یک فاصله درج می‌کند؛ در غیر این صورت نادیده گرفته می‌شود.
%r: شماره اتاق یا مشخصه درب واحد.
%e: شماره طبقه.
%C: مشخصه کشور، برگرفته از کلمه کلیدی country_post.
%l: نام شهرک یا ناحیه درون شهر (از glibc 2.24).
%z: کد پستی (Zip code).
%T: شهرک یا شهر.
%S: ایالت، استان یا فرمانداری.
%c: نام کشور، همان‌طور که از رکورد داده استخراج شده است.

هر توصیف‌گر فیلد می‌تواند بعد از '%' دارای یک 'R' باشد تا مشخص کند اطلاعات از نسخه لاتین‌نویسی‌شده (رومانیزه) موجودیت خوانده می‌شود.

country_name: به همراه نام کشور به زبان سند جاری (مثلاً "Deutschland" برای متغیر محلی de_DE).
country_post: به همراه مخفف کد پستی کشور (به CERT_MAILCODES مراجعه کنید).
country_ab2: به همراه مخفف دوحرفی کشور (استاندارد ISO 3166).
country_ab3: به همراه مخفف سه‌حرفی کشور (استاندارد ISO 3166).
country_num: به همراه کد عددی کشور (استاندارد ISO 3166).
country_car: به همراه کد بین‌المللی پلاک خودروی کشور.
country_isbn: به همراه پیش‌شماره بین‌المللی کتاب یا شابک (ISBN).
lang_name: به همراه نام زبان به زبان سند جاری.
lang_ab: به همراه مخفف دوحرفی زبان (استاندارد ISO 639).
lang_term: به همراه مخفف سه‌حرفی اصطلاح‌شناسی زبان (استاندارد ISO 639-2/T).
lang_lib: به همراه مخفف سه‌حرفی کتابخانه‌ای زبان (استاندارد ISO 639-2/B). برنامه‌ها به طور کلی باید lang_term را بر lang_lib ترجیح دهند.

تعریف LC_ADDRESS با رشته END LC_ADDRESS خاتمه می‌یابد.

LC_CTYPE

تعریف با عبارت LC_CTYPE در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

upper: به همراه فهرستی از حروف بزرگ. حروف A تا Z به طور خودکار گنجانده می‌شوند. نویسه‌هایی که در دسته‌های cntrl، digit، punct یا space تعریف شده باشند مجاز نیستند.
lower: به همراه فهرستی از حروف کوچک. حروف a تا z به طور خودکار گنجانده می‌شوند. نویسه‌هایی که در دسته‌های cntrl، digit، punct یا space تعریف شده باشند مجاز نیستند.
alpha: به همراه فهرستی از حروف الفبا. تمام نویسه‌هایی که در دسته‌های upper یا lower تعریف شده باشند به طور خودکار گنجانده می‌شوند. نویسه‌هایی که در دسته‌های cntrl، digit، punct یا space تعریف شده باشند مجاز نیستند.
digit: به همراه نویسه‌هایی که به عنوان ارقام عددی طبقه‌بندی می‌شوند. تنها ارقام 0 تا 9 مجاز هستند و به طور پیش‌فرض در این دسته گنجانده شده‌اند.
space: به همراه فهرستی از نویسه‌هایی که به عنوان فضای خالی (white-space) تعریف می‌شوند. نویسه‌هایی که در دسته‌های upper، lower، alpha، digit، graph یا xdigit تعریف شده باشند مجاز نیستند. نویسه‌های <space>، <form-feed>، <newline>، <carriage-return>، <tab> و <vertical-tab> به طور خودکار گنجانده می‌شوند.
cntrl: به همراه فهرستی از نویسه‌های کنترلی. نویسه‌هایی که در دسته‌های upper، lower، alpha، digit، punct، graph، print یا xdigit تعریف شده باشند مجاز نیستند.
punct: به همراه فهرستی از علائم نگارشی. نویسه‌هایی که در دسته‌های upper، lower، alpha، digit، cntrl، xdigit یا نویسه <space> تعریف شده باشند مجاز نیستند.
graph: به همراه فهرستی از نویسه‌های قابل چاپ، بدون شامل شدن نویسه <space>. نویسه‌های تعریف‌شده در دسته‌های upper، lower، alpha، digit، xdigit و punct به طور خودکار گنجانده می‌شوند. نویسه‌های تعریف‌شده به عنوان cntrl مجاز نیستند.
print: به همراه فهرستی از نویسه‌های قابل چاپ، شامل نویسه <space>. نویسه‌های تعریف‌شده در دسته‌های upper، lower، alpha، digit، xdigit، punct و نویسه <space> به طور خودکار گنجانده می‌شوند. نویسه‌های تعریف‌شده به عنوان cntrl مجاز نیستند.
xdigit: به همراه فهرستی از نویسه‌هایی که به عنوان ارقام شانزده‌شانزدهی (هگزادسیمال) طبقه‌بندی می‌شوند. ارقام ده‌دهی باید به همراه یک یا چند مجموعه شش‌تایی از کاراکترها به ترتیب صعودی مشخص شوند. نویسه‌های زیر به صورت پیش‌فرض گنجانده شده‌اند: 0 تا 9، a تا f، A تا F.
blank: به همراه فهرستی از نویسه‌های طبقه‌بندی‌شده به عنوان نویسه فاصله خالی ( blank ). نویسه‌های <space> و <tab> به صورت خودکار گنجانده می‌شوند.
charclass: به همراه فهرستی از نام‌های رده‌های کاراکتری اختصاصی متغیر محلی که سپس در همان متغیر محلی تعریف می‌شوند.
toupper: به همراه فهرستی از نگاشت‌ها از حروف کوچک به بزرگ. هر نگاشت جفتی از یک حرف کوچک و یک حرف بزرگ است که با , جدا شده و داخل پرانتز قرار گرفته است.
tolower: به همراه فهرستی از نگاشت‌ها از حروف بزرگ به کوچک. اگر کلمه کلیدی tolower وجود نداشته باشد، معکوس فهرست toupper استفاده می‌شود.
map totitle: به همراه فهرستی از جفت‌های نگاشت کاراکترها و حروف برای استفاده در عناوین و سرتیترها (headings).
class: به همراه تعریف یک رده کاراکتری اختصاصی متغیر محلی، که با نام رده آغاز شده و به دنبال آن نویسه‌های متعلق به آن رده می‌آیند.
charconv: به همراه فهرستی از نام‌های نگاشت نویسه اختصاصی متغیر محلی که سپس در متغیر محلی تعریف می‌شوند.
outdigit: به همراه فهرستی از ارقام جایگزین خروجی برای متغیر محلی.
map to_inpunct: به همراه فهرستی از جفت‌های نگاشت ارقام و جداکننده‌های جایگزین برای ارقام ورودی متغیر محلی.
map to_outpunct: به همراه فهرستی از جفت‌های نگاشت جداکننده‌های جایگزین برای خروجی متغیر محلی.
translit_start: آغاز بخش قوانین نویسه‌گردانی (transliteration) را نشان می‌دهد. این بخش می‌تواند با کلمه کلیدی include آغاز شود و در ادامه قوانین و بازتعریف‌های اختصاصی متغیر محلی بیایند. هر قاعده‌ای که در فایل متغیر محلی مشخص شود بر هر قاعده‌ای که از سایر فایل‌ها کپی یا گنجانده شده باشد اولویت دارد. در صورت تعریف قوانین تکراری در فایل متغیر محلی، تنها قاعده نخست به کار گرفته می‌شود.

: یک قاعده نویسه‌گردانی شامل نویسه‌ای است که باید نویسه‌گردانی شود و به دنبال آن فهرستی از اهداف نویسه‌گردانی با نقطه ویرگول (semicolon) جدا می‌شوند. نخستین هدفی که در مجموعه کاراکترهای مقصد قابل نمایش باشد استفاده می‌شود؛ اگر هیچ‌یک قابل نمایش نباشند، نویسه default_missing به جای آن استفاده خواهد شد.

include: در بخش قوانین نویسه‌گردانی، یک فایل قوانین نویسه‌گردانی (و به صورت اختیاری یک فایل نگاشت مجموعه نویسه‌ها یا repertoire map) را اضافه می‌کند.
default_missing: در بخش قوانین نویسه‌گردانی، نویسه پیش‌فرضی را تعیین می‌کند که باید در زمان عدم امکان نمایش هیچ‌یک از اهداف در مجموعه کاراکترهای مقصد، برای نویسه‌گردانی به کار رود.
translit_end: پایان قوانین نویسه‌گردانی را نشان می‌دهد.

تعریف LC_CTYPE با رشته END LC_CTYPE خاتمه می‌یابد.

LC_COLLATE

توجه داشته باشید که glibc از تمام گزینه‌های تعریف‌شده در استاندارد POSIX پشتیبانی نمی‌کند و تنها گزینه‌های شرح داده شده در زیر (تا نگارش glibc 2.23) پشتیبانی می‌شوند.

تعریف با عبارت LC_COLLATE در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

coll_weight_max: به همراه عددی که بیانگر سطوح مرتب‌سازی استفاده‌شده است. این کلمه کلیدی شناخته می‌شود اما توسط glibc نادیده گرفته خواهد شد.
collating-element: به همراه تعریف یک نماد عنصر مرتب‌سازی که نمایانگر یک عنصر مرتب‌سازی چندنویسه‌ای است.
collating-symbol: به همراه تعریف نماد مرتب‌سازی که می‌تواند در عبارت‌های ترتیب مرتب‌سازی به کار رود.
define: به همراه string جهت ارزیابی در ساختار ifdef string / else / endif.
reorder-after: به همراه بازتعریف یک قاعده مرتب‌سازی.
reorder-end: پایان بازتعریف قاعده مرتب‌سازی را نشان می‌دهد.
reorder-sections-after: به همراه نام یک خط یا اسکریپت که بخش‌های فهرست‌شده باید پس از آن مرتب شوند.
reorder-sections-end: پایان مرتب‌سازی مجدد بخش‌ها را مشخص می‌کند.
script: به همراه تعریف و اعلان یک خط (script).
symbol-equivalence: به همراه نماد مرتب‌سازی که معادل نماد مرتب‌سازی تعریف‌شده دیگری قرار می‌گیرد.

تعریف قاعده ترتیب مرتب‌سازی با سطری به شکل زیر آغاز می‌شود:

order_start: به همراه فهرستی از کلمات کلیدی انتخاب‌شده از forward، backward یا position. تعریف ترتیب شامل خطوطی است که ترتیب مرتب‌سازی را توصیف می‌کنند و با کلمه کلیدی order_end پایان می‌پذیرد.

تعریف LC_COLLATE با رشته END LC_COLLATE خاتمه می‌یابد.

LC_IDENTIFICATION

تعریف با عبارت LC_IDENTIFICATION در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

title: به همراه عنوان سند متغیر محلی (مانند "Maori language locale for New Zealand").
source: به همراه نام سازمان یا تشکیلاتی که از این سند نگهداری می‌کند.
address: به همراه نشانی سازمانی که از این سند نگهداری می‌کند.
contact: به همراه نام شخص رابط در سازمانی که از این سند نگهداری می‌کند.
email: به همراه نشانی ایمیل شخص یا سازمانی که از این سند نگهداری می‌کند.
tel: به همراه شماره تلفن (با قالب بین‌المللی) سازمانی که از این سند نگهداری می‌کند. از نگارش glibc 2.24 این کلمه کلیدی منسوخ شده و به نفع سایر روش‌های تماس توصیه نمی‌شود.
fax: به همراه شماره نمابر یا فکس (با قالب بین‌المللی) سازمانی که از این سند نگهداری می‌کند. از نگارش glibc 2.24 این کلمه کلیدی منسوخ شده است.
language: به همراه نام زبانی که این سند برای آن اعمال می‌شود.
territory: به همراه نام کشور یا محدوده جغرافیایی که این سند برای آن اعمال می‌شود.
audience: به همراه توضیحی درباره مخاطبانی که این سند برای آن‌ها در نظر گرفته شده است.
application: به همراه توضیحی درباره هرگونه کاربرد خاصی که این سند برای آن طراحی شده است.
abbreviation: به همراه نام کوتاه ارائه‌دهنده یا منبع این سند.
revision: به همراه شماره بازنگری (نسخه ویرایش) این سند.
date: به همراه تاریخ بازنگری این سند.

علاوه بر این، برای هر یک از دسته‌بندی‌های تعریف‌شده در سند، باید خطی با کلمه کلیدی category آغاز شود که پس از آن موارد زیر می‌آیند:

(1): رشته‌ای که این تعریف دسته متغیر محلی را مشخص می‌کند،
(2): یک علامت نقطه ویرگول (;)، و
(3): یکی از شناسه‌های LC_*.

تعریف LC_IDENTIFICATION با رشته END LC_IDENTIFICATION خاتمه می‌یابد.

LC_MESSAGES

تعریف با عبارت LC_MESSAGES در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

yesexpr: به همراه یک عبارت باقاعده (regular expression) که پاسخ‌های مثبت مجاز را توصیف می‌کند.
noexpr: به همراه یک عبارت باقاعده که پاسخ‌های منفی مجاز را توصیف می‌کند.
yesstr: به همراه رشته خروجی متناظر با "بله".
nostr: به همراه رشته خروجی متناظر با "خیر".

تعریف LC_MESSAGES با رشته END LC_MESSAGES خاتمه می‌یابد.

LC_MEASUREMENT

تعریف با عبارت LC_MEASUREMENT در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

measurement: به همراه عددی که استاندارد مورداستفاده برای اندازه‌گیری را مشخص می‌کند. مقادیر زیر به رسمیت شناخته می‌شوند:

1: سامانه متری (Metric).
2: واحدهای مرسوم در ایالات متحده (US customary measurements).

تعریف LC_MEASUREMENT با رشته END LC_MEASUREMENT خاتمه می‌یابد.

LC_MONETARY

تعریف با عبارت LC_MONETARY در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

int_curr_symbol: به همراه نماد بین‌المللی یکای پول. این مقدار باید یک رشته ۴ نویسه‌ای شامل نماد بین‌المللی پول طبق تعریف استاندارد ISO 4217 (سه نویسه) و به دنبال آن یک نویسه جداکننده باشد.
currency_symbol: به همراه نماد محلی یکای پول.
mon_decimal_point: به همراه رشته تک‌نویسه‌ای که به عنوان جداکننده ممیز اعشاری هنگام قالب‌بندی مقادیر پولی استفاده خواهد شد.
mon_thousands_sep: به همراه رشته تک‌نویسه‌ای که به عنوان جداکننده ارقام سه‌تایی هنگام قالب‌بندی مقادیر پولی به کار می‌رود.
mon_grouping: به همراه دنباله‌ای از اعداد صحیح جداشده با نقطه ویرگول که نحوه گروه‌بندی ارقام مقادیر پولی را مشخص می‌کنند. برای جزئیات به grouping در ادامه مراجعه فرمایید.
positive_sign: به همراه رشته‌ای که برای نشان دادن علامت مثبت مقادیر پولی استفاده می‌شود.
negative_sign: به همراه رشته‌ای که برای نشان دادن علامت منفی مقادیر پولی استفاده می‌شود.
int_frac_digits: به همراه تعداد ارقام اعشاری (کسری) که باید هنگام قالب‌بندی با int_curr_symbol استفاده شوند.
frac_digits: به همراه تعداد ارقام اعشاری که باید هنگام قالب‌بندی با currency_symbol استفاده شوند.
p_cs_precedes: به همراه یک عدد صحیح که موقعیت قرارگیری currency_symbol را برای مقادیر پولی غیرمنفی مشخص می‌کند:

0: نماد پول بعد از مقدار عددی قرار می‌گیرد.
1: نماد پول قبل از مقدار عددی قرار می‌گیرد.

p_sep_by_space: به همراه یک عدد صحیح که نحوه جداسازی currency_symbol، رشته علامت و مقدار عددی را برای مقادیر پولی غیرمنفی تعیین می‌کند. مقادیر زیر شناخته شده هستند:

0: هیچ فاصله‌ای نماد پول و مقدار عددی را جدا نمی‌کند.
1: اگر نماد پول و رشته علامت در کنار یکدیگر باشند، یک فاصله آن‌ها را از مقدار عددی جدا می‌کند؛ در غیر این صورت، یک فاصله نماد پول و مقدار عددی را جدا می‌سازد.
2: اگر نماد پول و رشته علامت در کنار یکدیگر باشند، یک فاصله آن‌ها را از مقدار عددی جدا می‌کند؛ در غیر این صورت، یک فاصله رشته علامت و مقدار عددی را جدا می‌سازد.

n_cs_precedes: به همراه یک عدد صحیح که موقعیت قرارگیری currency_symbol را برای مقادیر پولی منفی مشخص می‌کند. مقادیر مشابه با p_cs_precedes به رسمیت شناخته می‌شوند.
n_sep_by_space: به همراه یک عدد صحیح که نحوه جداسازی currency_symbol، رشته علامت و مقدار عددی را برای مقادیر پولی منفی تعیین می‌کند. مقادیر مشابه با p_sep_by_space به رسمیت شناخته می‌شوند.
p_sign_posn: به همراه یک عدد صحیح که محل قرارگیری positive_sign را برای مقادیر پولی غیرمنفی مشخص می‌سازد:

0: پرانتزها کل مقدار عددی و currency_symbol یا int_curr_symbol را در بر می‌گیرند.
1: رشته علامت قبل از مقدار عددی و currency_symbol یا int_curr_symbol قرار می‌گیرد.
2: رشته علامت بعد از مقدار عددی و currency_symbol یا int_curr_symbol قرار می‌گیرد.
3: رشته علامت بلافاصله قبل از currency_symbol یا int_curr_symbol قرار می‌گیرد.
4: رشته علامت بلافاصله بعد از currency_symbol یا int_curr_symbol قرار می‌گیرد.

n_sign_posn: به همراه یک عدد صحیح که محل قرارگیری negative_sign را برای مقادیر پولی منفی مشخص می‌سازد. مقادیر مجاز همانند p_sign_posn هستند.
int_p_cs_precedes: به همراه یک عدد صحیح که موقعیت قرارگیری int_curr_symbol را برای مقادیر پولی بین‌المللی غیرمنفی مشخص می‌کند. مقادیر مجاز همانند p_cs_precedes هستند.
int_n_cs_precedes: به همراه یک عدد صحیح که موقعیت قرارگیری int_curr_symbol را برای مقادیر پولی بین‌المللی منفی مشخص می‌کند. مقادیر مجاز همانند p_cs_precedes هستند.
int_p_sep_by_space: به همراه یک عدد صحیح که نحوه جداسازی int_curr_symbol، رشته علامت و مقدار عددی را برای مقادیر پولی بین‌المللی غیرمنفی تعیین می‌کند. مقادیر مجاز همانند p_sep_by_space هستند.
int_n_sep_by_space: به همراه یک عدد صحیح که نحوه جداسازی int_curr_symbol، رشته علامت و مقدار عددی را برای مقادیر پولی بین‌المللی منفی تعیین می‌کند. مقادیر مجاز همانند p_sep_by_space هستند.
int_p_sign_posn: به همراه یک عدد صحیح که محل قرارگیری positive_sign را برای مقادیر پولی بین‌المللی غیرمنفی تعیین می‌کند. مقادیر مجاز همانند p_sign_posn هستند.
int_n_sign_posn: به همراه یک عدد صحیح که محل قرارگیری negative_sign را برای مقادیر پولی بین‌المللی منفی تعیین می‌کند. مقادیر مجاز همانند p_sign_posn هستند.

تعریف LC_MONETARY با رشته END LC_MONETARY خاتمه می‌یابد.

LC_NAME

تعریف با عبارت LC_NAME در ستون نخست آغاز می‌شود.

کلمات کلیدی گوناگونی مجاز هستند، اما تنها name_fmt اجباری است. سایر کلمات کلیدی تنها در صورتی مورد نیازند که در این متغیر محلی کاربرد عناوین احترام‌آمیز مربوطه مرسوم باشد. کلمات کلیدی مجاز عبارتند از:

name_fmt: به همراه رشته‌ای شامل توصیف‌گرهای فیلد که قالب به کار رفته برای نام اشخاص را در این متغیر محلی مشخص می‌کند. توصیف‌گرهای زیر به رسمیت شناخته می‌شوند:

%f: نام خانوادگی (نام‌های خانوادگی).
%F: نام‌های خانوادگی با حروف بزرگ انگلیسی.
%g: نام کوچک نخست (نام اصلی).
%G: حرف نخست نام کوچک.
%l: نام کوچک نخست با حروف لاتین.
%o: سایر نام‌های کوتاه‌تر یا مستعار.
%m: نام‌های کوچک میانی یا تکمیلی.
%M: حروف نخست نام‌های کوچک میانی یا تکمیلی.
%p: شغل یا حرفه.
%s: عنوان احترام‌آمیز، مانند "Doctor" (دکتر).
%S: مخفف عنوان احترام‌آمیز، مانند ".Mr" یا ".Dr".
%d: عنوان احترام‌آمیز بر اساس قراردادهای FDCC-sets.
%t: در صورت خالی بودن مقدار توصیف‌گر قبلی، رشته خالی؛ در غیر این صورت نویسه فاصله درج می‌شود.

name_gen: به همراه عنوان احترام‌آمیز عمومی برای تمام جنسیت‌ها.
name_mr: به همراه عنوان احترام‌آمیز برای آقایان.
name_mrs: به همراه عنوان احترام‌آمیز برای بانوان متأهل.
name_miss: به همراه عنوان احترام‌آمیز برای بانوان مجرد.
name_ms: به همراه عنوان احترام‌آمیز عمومی معتبر برای تمامی بانوان.

تعریف LC_NAME با رشته END LC_NAME خاتمه می‌یابد.

LC_NUMERIC

تعریف با عبارت LC_NUMERIC در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

decimal_point: به همراه رشته تک‌نویسه‌ای که به عنوان جداکننده ممیز اعشاری هنگام قالب‌بندی مقادیر عددی استفاده خواهد شد.
thousands_sep: به همراه رشته تک‌نویسه‌ای که به عنوان جداکننده ارقام سه‌تایی هنگام قالب‌بندی مقادیر عددی استفاده می‌شود.
grouping: به همراه دنباله‌ای از اعداد صحیح جداشده با نقطه ویرگول که نحوه گروه‌بندی ارقام مقادیر عددی را مشخص می‌کنند.

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

تعریف LC_NUMERIC با رشته END LC_NUMERIC خاتمه می‌یابد.

LC_PAPER

تعریف با عبارت LC_PAPER در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

height: به همراه ارتفاع کاغذ استاندارد بر حسب میلی‌متر.
width: به همراه پهنای کاغذ استاندارد بر حسب میلی‌متر.

تعریف LC_PAPER با رشته END LC_PAPER خاتمه می‌یابد.

LC_TELEPHONE

تعریف با عبارت LC_TELEPHONE در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

tel_int_fmt: به همراه رشته‌ای شامل توصیف‌گرهای فیلد که قالب به کار رفته برای شماره‌گیری شماره‌های بین‌المللی را مشخص می‌کند. توصیف‌گرهای زیر به رسمیت شناخته می‌شوند:

%a: پیش‌شماره منطقه بدون پیشوند کشوری (پیشوند معمولاً "00" است).
%A: پیش‌شماره منطقه به همراه پیشوند کشوری.
%l: شماره محلی (درون محدوده پیش‌شماره منطقه).
%e: شماره داخلی (به شماره محلی).
%c: کد کشور.
%C: کد اپراتور جایگزین که برای تماس با خارج از کشور استفاده می‌شود.
%t: در صورت خالی بودن مقدار توصیف‌گر پیشین، رشته خالی؛ در غیر این صورت یک نویسه فاصله درج می‌کند.

tel_dom_fmt: به همراه رشته‌ای شامل توصیف‌گرهای فیلد که قالب به کار رفته برای شماره‌گیری شماره‌های داخلی کشور را مشخص می‌کند. توصیف‌گرهای شناخته‌شده همانند tel_int_fmt هستند.
int_select: به همراه پیشوندی که برای برقراری تماس با شماره‌های تلفن بین‌المللی شماره‌گیری می‌شود.
int_prefix: به همراه پیشوندی که از سایر کشورها برای شماره‌گیری این کشور استفاده می‌شود.

تعریف LC_TELEPHONE با رشته END LC_TELEPHONE خاتمه می‌یابد.

LC_TIME

تعریف با عبارت LC_TIME در ستون نخست آغاز می‌شود.

کلمات کلیدی مجاز به شرح زیر هستند:

abday: به همراه فهرستی از نام‌های مخفف روزهای هفته. این فهرست با اولین روز هفته همان‌طور که توسط week مشخص شده آغاز می‌شود (پیش‌فرض یکشنبه). به بخش نکات (NOTES) مراجعه کنید.
day: به همراه فهرستی از نام‌های کامل روزهای هفته. این فهرست با اولین روز هفته طبق مشخصه week آغاز می‌شود (پیش‌فرض یکشنبه). به بخش نکات مراجعه فرمایید.
abmon: به همراه فهرستی از نام‌های مخفف ماه‌های سال.
mon: به همراه فهرستی از نام‌های کامل ماه‌های سال.
d_t_fmt: به همراه قالب مناسب تاریخ و زمان (برای ساختار نحو به strftime(3) مراجعه کنید).
d_fmt: به همراه قالب مناسب نمایش تاریخ (برای ساختار نحو به strftime(3) مراجعه کنید).
t_fmt: به همراه قالب مناسب نمایش زمان (برای ساختار نحو به strftime(3) مراجعه کنید).
am_pm: به همراه نمایش مناسب رشته‌های am و pm. برای متغیرهای محلی که از شیوه صبح/عصر (AM/PM) استفاده نمی‌کنند باید خالی گذاشته شود.
t_fmt_ampm: به همراه قالب مناسب زمان هنگام استفاده از قالب ساعت ۱۲ ساعته (برای نحو به strftime(3) مراجعه کنید). این فیلد برای متغیرهای محلی که از AM/PM استفاده نمی‌کنند باید خالی گذاشته شود.
era: به همراه رشته‌های جداشده با نقطه ویرگول که نحوه شمارش و نمایش سال‌ها را برای هر دوره زمانی (مبدأ گاه‌شماری یا era) در متغیر محلی مشخص می‌کند. هر رشته دارای قالب زیر است:

direction:offset:start_date:end_date:era_name:era_format

فیلدها به شرح زیر تعریف می‌شوند:

direction: یا + یا -. علامت + بدین معناست که سال‌های نزدیک‌تر به start_date شماره کمتری نسبت به سال‌های نزدیک‌تر به end_date دارند. - به معنای خلاف آن است.
offset: شماره سال نزدیک‌ترین سال به start_date در آن دوره، متناظر با توصیف‌گر %Ey (به strptime(3) مراجعه کنید).
start_date: آغاز دوره به شکل yyyy/mm/dd. سال‌های پیش از میلاد مسیح (AD 1) با اعداد منفی نشان داده می‌شوند.
end_date: پایان دوره به شکل yyyy/mm/dd، یا یکی از دو مقدار ویژه -* یا +*. مقدار -* به این معنی است که تاریخ پایان، آغاز زمان است. +* بدین معناست که تاریخ پایان، انتهای زمان است.
era_name: نام دوره متناظر با توصیف‌گر %EC (به strptime(3) مراجعه کنید).
era_format: قالب سال در دوره متناظر با توصیف‌گر %EY (به strptime(3) مراجعه کنید).

era_d_fmt: به همراه قالب تاریخ در نمایش دوره‌ای جایگزین، متناظر با توصیف‌گر %Ex (به strptime(3) مراجعه کنید).
era_t_fmt: به همراه قالب زمان در نمایش دوره‌ای جایگزین، متناظر با توصیف‌گر %EX (به strptime(3) مراجعه کنید).
era_d_t_fmt: به همراه قالب تاریخ و زمان در نمایش دوره‌ای جایگزین، متناظر با توصیف‌گر %Ec (به strptime(3) مراجعه کنید).
alt_digits: به همراه ارقام جایگزین مورداستفاده برای تاریخ و زمان در متغیر محلی.
week: به همراه فهرستی از سه مقدار جداشده با نقطه ویرگول: تعداد روزهای یک هفته (پیش‌فرض ۷)، تاریخی برای آغاز هفته (به طور پیش‌فرض متناظر با یکشنبه)، و حداقل طول هفته نخست سال (به طور پیش‌فرض ۴). با توجه به شروع هفته، مقدار 19971130 باید برای یکشنبه و 19971201 برای دوشنبه استفاده شود. به بخش نکات مراجعه کنید.
first_weekday (از glibc 2.2): به همراه شماره روز از فهرست day که باید به عنوان نخستین روز هفته در برنامه‌های تقویم نمایش داده شود. مقدار پیش‌فرض 1 بسته به مقدار دومین آیتم در فهرست week متناظر با یکشنبه یا دوشنبه خواهد بود. به بخش نکات مراجعه فرمایید.
first_workday (از glibc 2.2): به همراه شماره نخستین روز کاری از فهرست day. مقدار پیش‌فرض 2 است. به بخش نکات مراجعه کنید.
cal_direction: به همراه مقداری عددی که جهت نمایش تاریخ‌های تقویم را به شرح زیر مشخص می‌کند:

1: چپ به راست از بالا.
2: بالا به پایین از چپ.
3: راست به چپ از بالا.

date_fmt: به همراه نمایش مناسب تاریخ برای date(1) (برای نحو به strftime(3) مراجعه کنید).

تعریف LC_TIME با رشته END LC_TIME خاتمه می‌یابد.

فایل‌ها (FILES)

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

استانداردها (STANDARDS)

POSIX.2.

نکات (NOTES)

دیدگاه و دانش جمعی جامعه توسعه‌دهندگان کتابخانه GNU C در ارتباط با abday، day، week، first_weekday و first_workday در نشانی اینترنتی https://sourceware.org/glibc/wiki/Locales به شرح زیر بیان شده است:

•: مقدار دومین مورد در فهرست week پایه و مبنای فهرست‌های abday و day را مشخص می‌کند.
•: first_weekday میزان جابه‌جایی (offset) نخستین روز هفته را در فهرست‌های abday و day مشخص می‌سازد.
•: به دلایل سازگاری، تمام متغیرهای محلی glibc باید مقدار دومین مورد فهرست week را برابر با 19971130 (یکشنبه) قرار داده و فهرست‌های abday و day را بر این اساس تنظیم کنند؛ همچنین مقدار first_weekday و first_workday را بسته به اینکه آغاز هفته و هفته کاری در آن متغیر محلی از یکشنبه یا دوشنبه است، برابر با 1 یا 2 تنظیم نمایند.

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

iconv(1), locale(1), localedef(1), localeconv(3), newlocale(3), setlocale(3), strftime(3), strptime(3), uselocale(3), charmap(5), charsets(7), locale(7), unicode(7), utf-8(7)

مه ۲۰۲۵

man-pages