.TH "LOCALE" "5" "مه ۲۰۲۵" "man-pages" "فایلهای پیکربندی" .SH "نام (NAME)" locale \- ساختار و قالب فایل تعریف اطلاعات متغیرهای محلی .SH "توضیحات (DESCRIPTION)" فایل تعریف \fIlocale\fR شامل جدولها و اطلاعاتی است که نحوه قالببندی اعداد، تاریخ، زمان، واحد پول و دستهبندی کاراکترها را برای یک زبان یا منطقه جغرافیایی مشخص میکند. .PP فایل تعریف .B locale شامل تمام اطلاعاتی است که دستور .BR localedef (1) برای تبدیل آن به پایگاه‌داده باینری متغیرهای محلی نیاز دارد. .PP فایل‌های تعریف از بخش‌هایی تشکیل شده‌اند که هر یک از آن‌ها یک دسته‌بندی محلی را با جزئیات توصیف می‌کند. برای جزئیات بیشتر درباره این دسته‌بندی‌ها به .BR locale (7) مراجعه کنید. .SS "نحو (Syntax)" فایل تعریف متغیر محلی با یک سرآیند آغاز می‌شود که می‌تواند شامل کلمات کلیدی زیر باشد: .TP .I escape_char به همراه نویسه‌ای می‌آید که باید به عنوان نویسه گریز (escape-character) برای ادامه فایل به کار رود تا نویسه‌هایی را مشخص کند که باید به صورت خاص تفسیر شوند. مقدار پیش‌فرض آن ممیز وارونه (\[rs]) است. .TP .I comment_char به همراه نویسه‌ای می‌آید که به عنوان نویسه یادداشت (کامنت) برای ادامه فایل استفاده خواهد شد. مقدار پیش‌فرض آن علامت هش (#) است. .PP تعریف متغیر محلی برای هر دسته‌بندی محلی یک بخش دارد. هر بخش را می‌توان از یک متغیر محلی موجود دیگر کپی کرد یا از ابتدا تعریف نمود. اگر دسته‌بندی باید کپی شود، تنها کلمه کلیدی معتبر در تعریف، .I copy است که به دنبال آن نام متغیر محلی مورد نظر برای کپی داخل علامت نقل‌قول دوتایی قرار می‌گیرد. استثناهای این قاعده عبارتند از .B LC_COLLATE و .B LC_CTYPE که در آن‌ها عبارت .I copy می‌تواند با قوانین اختصاصی متغیر محلی و بازتعریف‌های انتخابی همراه شود. .PP هنگام تعریف یک متغیر محلی یا یک دسته‌بندی از پایه، باید از یکی از فایل‌های تعریف متغیر محلی موجود در سیستم به عنوان الگو و مرجع استفاده شود تا از قراردادهای رایج glibc پیروی گردد. .SS "بخش‌های دسته‌بندی محلی (Locale category sections)" دسته‌بندی‌های زیر توسط استاندارد POSIX تعریف شده‌اند: .IP \[bu] 3 .B LC_CTYPE .IP \[bu] .B LC_COLLATE .IP \[bu] .B LC_MESSAGES .IP \[bu] .B LC_MONETARY .IP \[bu] .B LC_NUMERIC .IP \[bu] .B LC_TIME .PP علاوه بر این، از نسخه glibc 2.2 به بعد، کتابخانه GNU C از دسته‌بندی‌های غیراستاندارد زیر نیز پشتیبانی می‌کند: .IP \[bu] 3 .B LC_ADDRESS .IP \[bu] .B LC_IDENTIFICATION .IP \[bu] .B LC_MEASUREMENT .IP \[bu] .B LC_NAME .IP \[bu] .B LC_PAPER .IP \[bu] .B LC_TELEPHONE .PP برای توضیحات دقیق‌تر درباره هر یک از این دسته‌بندی‌ها به .BR locale (7) مراجعه کنید. .SS LC_ADDRESS تعریف با عبارت .I LC_ADDRESS در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I postal_fmt به همراه رشته‌ای شامل توصیف‌گرهای فیلد که قالب نشانی‌های پستی را در این متغیر محلی مشخص می‌کند. توصیف‌گرهای زیر شناخته شده هستند: .RS .TP %n نام شخص، که احتمالاً با کلمه کلیدی .I name_fmt از دسته .B LC_NAME ساخته شده است (از glibc 2.24). .TP 4 %a از طریق شخص، یا نام سازمان (تحویل به/مراقبت). .TP %f نام شرکت یا بنگاه تجاری. .TP %d نام بخش یا دپارتمان. .TP %b نام ساختمان. .TP %s نام خیابان یا بلوک (مانند نشانی‌های ژاپنی). .TP %h شماره یا مشخصه پلاک خانه. .TP %N در صورت خالی نبودن مقدار توصیف‌گر پیشین، یک پایان خط (سطر جدید) درج می‌کند؛ در غیر این صورت نادیده گرفته می‌شود. .TP %t در صورت خالی نبودن مقدار توصیف‌گر پیشین، یک فاصله درج می‌کند؛ در غیر این صورت نادیده گرفته می‌شود. .TP %r شماره اتاق یا مشخصه درب واحد. .TP %e شماره طبقه. .TP %C مشخصه کشور، برگرفته از کلمه کلیدی .IR country_post . .TP %l نام شهرک یا ناحیه درون شهر (از glibc 2.24). .TP %z کد پستی (Zip code). .TP %T شهرک یا شهر. .TP %S ایالت، استان یا فرمانداری. .TP %c نام کشور، همان‌طور که از رکورد داده استخراج شده است. .PP هر توصیف‌گر فیلد می‌تواند بعد از \[aq]%\[aq] دارای یک \[aq]R\[aq] باشد تا مشخص کند اطلاعات از نسخه لاتین‌نویسی‌شده (رومانیزه) موجودیت خوانده می‌شود. .RE .TP .I country_name به همراه نام کشور به زبان سند جاری (مثلاً "Deutschland" برای متغیر محلی .BR de_DE ). .TP .I country_post به همراه مخفف کد پستی کشور (به CERT_MAILCODES مراجعه کنید). .TP .I country_ab2 به همراه مخفف دوحرفی کشور (استاندارد ISO\~3166). .TP .I country_ab3 به همراه مخفف سه‌حرفی کشور (استاندارد ISO\~3166). .TP .I country_num به همراه کد عددی کشور (استاندارد ISO\~3166). .TP .I country_car به همراه کد بین‌المللی پلاک خودروی کشور. .TP .I country_isbn به همراه پیش‌شماره بین‌المللی کتاب یا شابک (ISBN). .TP .I lang_name به همراه نام زبان به زبان سند جاری. .TP .I lang_ab به همراه مخفف دوحرفی زبان (استاندارد ISO\~639). .TP .I lang_term به همراه مخفف سه‌حرفی اصطلاح‌شناسی زبان (استاندارد ISO\~639-2/T). .TP .I lang_lib به همراه مخفف سه‌حرفی کتابخانه‌ای زبان (استاندارد ISO\~639-2/B). برنامه‌ها به طور کلی باید .I lang_term را بر .I lang_lib ترجیح دهند. .PP تعریف .B LC_ADDRESS با رشته .IR "END LC_ADDRESS" خاتمه می‌یابد. .SS LC_CTYPE تعریف با عبارت .I LC_CTYPE در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I upper به همراه فهرستی از حروف بزرگ. حروف .B A تا .B Z به طور خودکار گنجانده می‌شوند. نویسه‌هایی که در دسته‌های .BR cntrl ، .BR digit ، .BR punct یا .B space تعریف شده باشند مجاز نیستند. .TP .I lower به همراه فهرستی از حروف کوچک. حروف .B a تا .B z به طور خودکار گنجانده می‌شوند. نویسه‌هایی که در دسته‌های .BR cntrl ، .BR digit ، .BR punct یا .B space تعریف شده باشند مجاز نیستند. .TP .I alpha به همراه فهرستی از حروف الفبا. تمام نویسه‌هایی که در دسته‌های .B upper یا .B lower تعریف شده باشند به طور خودکار گنجانده می‌شوند. نویسه‌هایی که در دسته‌های .BR cntrl ، .BR digit ، .BR punct یا .B space تعریف شده باشند مجاز نیستند. .TP .I digit به همراه نویسه‌هایی که به عنوان ارقام عددی طبقه‌بندی می‌شوند. تنها ارقام .B 0 تا .B 9 مجاز هستند و به طور پیش‌فرض در این دسته گنجانده شده‌اند. .TP .I space به همراه فهرستی از نویسه‌هایی که به عنوان فضای خالی (white-space) تعریف می‌شوند. نویسه‌هایی که در دسته‌های .BR upper ، .BR lower ، .BR alpha ، .BR digit ، .BR graph یا .B xdigit تعریف شده باشند مجاز نیستند. نویسه‌های .BR ، .BR ، .BR ، .BR ، .BR و .B به طور خودکار گنجانده می‌شوند. .TP .I cntrl به همراه فهرستی از نویسه‌های کنترلی. نویسه‌هایی که در دسته‌های .BR upper ، .BR lower ، .BR alpha ، .BR digit ، .BR punct ، .BR graph ، .B print یا .B xdigit تعریف شده باشند مجاز نیستند. .TP .I punct به همراه فهرستی از علائم نگارشی. نویسه‌هایی که در دسته‌های .BR upper ، .BR lower ، .BR alpha ، .BR digit ، .BR cntrl ، .B xdigit یا نویسه .B تعریف شده باشند مجاز نیستند. .TP .I graph به همراه فهرستی از نویسه‌های قابل چاپ، بدون شامل شدن نویسه .BR . نویسه‌های تعریف‌شده در دسته‌های .BR upper ، .BR lower ، .BR alpha ، .BR digit ، .BR xdigit و .B punct به طور خودکار گنجانده می‌شوند. نویسه‌های تعریف‌شده به عنوان .B cntrl مجاز نیستند. .TP .I print به همراه فهرستی از نویسه‌های قابل چاپ، شامل نویسه .BR . نویسه‌های تعریف‌شده در دسته‌های .BR upper ، .BR lower ، .BR alpha ، .BR digit ، .BR xdigit ، .BR punct و نویسه .B به طور خودکار گنجانده می‌شوند. نویسه‌های تعریف‌شده به عنوان .B cntrl مجاز نیستند. .TP .I xdigit به همراه فهرستی از نویسه‌هایی که به عنوان ارقام شانزده‌شانزدهی (هگزادسیمال) طبقه‌بندی می‌شوند. ارقام ده‌دهی باید به همراه یک یا چند مجموعه شش‌تایی از کاراکترها به ترتیب صعودی مشخص شوند. نویسه‌های زیر به صورت پیش‌فرض گنجانده شده‌اند: .B 0 تا .BR 9 ، .B a تا .BR f ، .B A تا .BR F . .TP .I blank به همراه فهرستی از نویسه‌های طبقه‌بندی‌شده به عنوان نویسه فاصله خالی ( .BR blank ). نویسه‌های .B و .B به صورت خودکار گنجانده می‌شوند. .TP .I charclass به همراه فهرستی از نام‌های رده‌های کاراکتری اختصاصی متغیر محلی که سپس در همان متغیر محلی تعریف می‌شوند. .TP .I toupper به همراه فهرستی از نگاشت‌ها از حروف کوچک به بزرگ. هر نگاشت جفتی از یک حرف کوچک و یک حرف بزرگ است که با .B , جدا شده و داخل پرانتز قرار گرفته است. .TP .I tolower به همراه فهرستی از نگاشت‌ها از حروف بزرگ به کوچک. اگر کلمه کلیدی tolower وجود نداشته باشد، معکوس فهرست toupper استفاده می‌شود. .TP .I map totitle به همراه فهرستی از جفت‌های نگاشت کاراکترها و حروف برای استفاده در عناوین و سرتیترها (headings). .TP .I class به همراه تعریف یک رده کاراکتری اختصاصی متغیر محلی، که با نام رده آغاز شده و به دنبال آن نویسه‌های متعلق به آن رده می‌آیند. .TP .I charconv به همراه فهرستی از نام‌های نگاشت نویسه اختصاصی متغیر محلی که سپس در متغیر محلی تعریف می‌شوند. .TP .I outdigit به همراه فهرستی از ارقام جایگزین خروجی برای متغیر محلی. .TP .I map to_inpunct به همراه فهرستی از جفت‌های نگاشت ارقام و جداکننده‌های جایگزین برای ارقام ورودی متغیر محلی. .TP .I map to_outpunct به همراه فهرستی از جفت‌های نگاشت جداکننده‌های جایگزین برای خروجی متغیر محلی. .TP .I translit_start آغاز بخش قوانین نویسه‌گردانی (transliteration) را نشان می‌دهد. این بخش می‌تواند با کلمه کلیدی .I include آغاز شود و در ادامه قوانین و بازتعریف‌های اختصاصی متغیر محلی بیایند. هر قاعده‌ای که در فایل متغیر محلی مشخص شود بر هر قاعده‌ای که از سایر فایل‌ها کپی یا گنجانده شده باشد اولویت دارد. در صورت تعریف قوانین تکراری در فایل متغیر محلی، تنها قاعده نخست به کار گرفته می‌شود. .IP یک قاعده نویسه‌گردانی شامل نویسه‌ای است که باید نویسه‌گردانی شود و به دنبال آن فهرستی از اهداف نویسه‌گردانی با نقطه ویرگول (semicolon) جدا می‌شوند. نخستین هدفی که در مجموعه کاراکترهای مقصد قابل نمایش باشد استفاده می‌شود؛ اگر هیچ‌یک قابل نمایش نباشند، نویسه .I default_missing به جای آن استفاده خواهد شد. .TP .I include در بخش قوانین نویسه‌گردانی، یک فایل قوانین نویسه‌گردانی (و به صورت اختیاری یک فایل نگاشت مجموعه نویسه‌ها یا repertoire map) را اضافه می‌کند. .TP .I default_missing در بخش قوانین نویسه‌گردانی، نویسه پیش‌فرضی را تعیین می‌کند که باید در زمان عدم امکان نمایش هیچ‌یک از اهداف در مجموعه کاراکترهای مقصد، برای نویسه‌گردانی به کار رود. .TP .I translit_end پایان قوانین نویسه‌گردانی را نشان می‌دهد. .PP تعریف .B LC_CTYPE با رشته .IR "END LC_CTYPE" خاتمه می‌یابد. .SS LC_COLLATE توجه داشته باشید که glibc از تمام گزینه‌های تعریف‌شده در استاندارد POSIX پشتیبانی نمی‌کند و تنها گزینه‌های شرح داده شده در زیر (تا نگارش glibc 2.23) پشتیبانی می‌شوند. .PP تعریف با عبارت .I LC_COLLATE در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I coll_weight_max به همراه عددی که بیانگر سطوح مرتب‌سازی استفاده‌شده است. این کلمه کلیدی شناخته می‌شود اما توسط glibc نادیده گرفته خواهد شد. .TP .I collating\-element به همراه تعریف یک نماد عنصر مرتب‌سازی که نمایانگر یک عنصر مرتب‌سازی چندنویسه‌ای است. .TP .I collating\-symbol به همراه تعریف نماد مرتب‌سازی که می‌تواند در عبارت‌های ترتیب مرتب‌سازی به کار رود. .TP .I define به همراه .B string جهت ارزیابی در ساختار .I ifdef .B string / .I else / .IR endif . .TP .I reorder\-after به همراه بازتعریف یک قاعده مرتب‌سازی. .TP .I reorder\-end پایان بازتعریف قاعده مرتب‌سازی را نشان می‌دهد. .TP .I reorder\-sections\-after به همراه نام یک خط یا اسکریپت که بخش‌های فهرست‌شده باید پس از آن مرتب شوند. .TP .I reorder\-sections\-end پایان مرتب‌سازی مجدد بخش‌ها را مشخص می‌کند. .TP .I script به همراه تعریف و اعلان یک خط (script). .TP .I symbol\-equivalence به همراه نماد مرتب‌سازی که معادل نماد مرتب‌سازی تعریف‌شده دیگری قرار می‌گیرد. .PP تعریف قاعده ترتیب مرتب‌سازی با سطری به شکل زیر آغاز می‌شود: .TP .I order_start به همراه فهرستی از کلمات کلیدی انتخاب‌شده از .BR forward ، .B backward یا .BR position . تعریف ترتیب شامل خطوطی است که ترتیب مرتب‌سازی را توصیف می‌کنند و با کلمه کلیدی .I order_end پایان می‌پذیرد. .PP تعریف .B LC_COLLATE با رشته .IR "END LC_COLLATE" خاتمه می‌یابد. .SS LC_IDENTIFICATION تعریف با عبارت .I LC_IDENTIFICATION در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I title به همراه عنوان سند متغیر محلی (مانند "Maori language locale for New Zealand"). .TP .I source به همراه نام سازمان یا تشکیلاتی که از این سند نگهداری می‌کند. .TP .I address به همراه نشانی سازمانی که از این سند نگهداری می‌کند. .TP .I contact به همراه نام شخص رابط در سازمانی که از این سند نگهداری می‌کند. .TP .I email به همراه نشانی ایمیل شخص یا سازمانی که از این سند نگهداری می‌کند. .TP .I tel به همراه شماره تلفن (با قالب بین‌المللی) سازمانی که از این سند نگهداری می‌کند. از نگارش glibc 2.24 این کلمه کلیدی منسوخ شده و به نفع سایر روش‌های تماس توصیه نمی‌شود. .TP .I fax به همراه شماره نمابر یا فکس (با قالب بین‌المللی) سازمانی که از این سند نگهداری می‌کند. از نگارش glibc 2.24 این کلمه کلیدی منسوخ شده است. .TP .I language به همراه نام زبانی که این سند برای آن اعمال می‌شود. .TP .I territory به همراه نام کشور یا محدوده جغرافیایی که این سند برای آن اعمال می‌شود. .TP .I audience به همراه توضیحی درباره مخاطبانی که این سند برای آن‌ها در نظر گرفته شده است. .TP .I application به همراه توضیحی درباره هرگونه کاربرد خاصی که این سند برای آن طراحی شده است. .TP .I abbreviation به همراه نام کوتاه ارائه‌دهنده یا منبع این سند. .TP .I revision به همراه شماره بازنگری (نسخه ویرایش) این سند. .TP .I date به همراه تاریخ بازنگری این سند. .PP علاوه بر این، برای هر یک از دسته‌بندی‌های تعریف‌شده در سند، باید خطی با کلمه کلیدی .I category آغاز شود که پس از آن موارد زیر می‌آیند: .IP (1) 5 رشته‌ای که این تعریف دسته متغیر محلی را مشخص می‌کند، .IP (2) یک علامت نقطه ویرگول (;)، و .IP (3) یکی از شناسه‌های .BR LC_* . .PP تعریف .B LC_IDENTIFICATION با رشته .IR "END LC_IDENTIFICATION" خاتمه می‌یابد. .SS LC_MESSAGES تعریف با عبارت .I LC_MESSAGES در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I yesexpr به همراه یک عبارت باقاعده (regular expression) که پاسخ‌های مثبت مجاز را توصیف می‌کند. .TP .I noexpr به همراه یک عبارت باقاعده که پاسخ‌های منفی مجاز را توصیف می‌کند. .TP .I yesstr به همراه رشته خروجی متناظر با "بله". .TP .I nostr به همراه رشته خروجی متناظر با "خیر". .PP تعریف .B LC_MESSAGES با رشته .IR "END LC_MESSAGES" خاتمه می‌یابد. .SS LC_MEASUREMENT تعریف با عبارت .I LC_MEASUREMENT در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I measurement به همراه عددی که استاندارد مورداستفاده برای اندازه‌گیری را مشخص می‌کند. مقادیر زیر به رسمیت شناخته می‌شوند: .RS .TP 4 .B 1 سامانه متری (Metric). .TP .B 2 واحدهای مرسوم در ایالات متحده (US customary measurements). .RE .PP تعریف .B LC_MEASUREMENT با رشته .IR "END LC_MEASUREMENT" خاتمه می‌یابد. .SS LC_MONETARY تعریف با عبارت .I LC_MONETARY در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I int_curr_symbol به همراه نماد بین‌المللی یکای پول. این مقدار باید یک رشته ۴ نویسه‌ای شامل نماد بین‌المللی پول طبق تعریف استاندارد ISO\~4217 (سه نویسه) و به دنبال آن یک نویسه جداکننده باشد. .TP .I currency_symbol به همراه نماد محلی یکای پول. .TP .I mon_decimal_point به همراه رشته تک‌نویسه‌ای که به عنوان جداکننده ممیز اعشاری هنگام قالب‌بندی مقادیر پولی استفاده خواهد شد. .TP .I mon_thousands_sep به همراه رشته تک‌نویسه‌ای که به عنوان جداکننده ارقام سه‌تایی هنگام قالب‌بندی مقادیر پولی به کار می‌رود. .TP .I mon_grouping به همراه دنباله‌ای از اعداد صحیح جداشده با نقطه ویرگول که نحوه گروه‌بندی ارقام مقادیر پولی را مشخص می‌کنند. برای جزئیات به .I grouping در ادامه مراجعه فرمایید. .TP .I positive_sign به همراه رشته‌ای که برای نشان دادن علامت مثبت مقادیر پولی استفاده می‌شود. .TP .I negative_sign به همراه رشته‌ای که برای نشان دادن علامت منفی مقادیر پولی استفاده می‌شود. .TP .I int_frac_digits به همراه تعداد ارقام اعشاری (کسری) که باید هنگام قالب‌بندی با .I int_curr_symbol استفاده شوند. .TP .I frac_digits به همراه تعداد ارقام اعشاری که باید هنگام قالب‌بندی با .I currency_symbol استفاده شوند. .TP .I p_cs_precedes به همراه یک عدد صحیح که موقعیت قرارگیری .I currency_symbol را برای مقادیر پولی غیرمنفی مشخص می‌کند: .RS .TP 4 .B 0 نماد پول بعد از مقدار عددی قرار می‌گیرد. .TP .B 1 نماد پول قبل از مقدار عددی قرار می‌گیرد. .RE .TP .I p_sep_by_space به همراه یک عدد صحیح که نحوه جداسازی .IR currency_symbol ، رشته علامت و مقدار عددی را برای مقادیر پولی غیرمنفی تعیین می‌کند. مقادیر زیر شناخته شده هستند: .RS .TP 4 .B 0 هیچ فاصله‌ای نماد پول و مقدار عددی را جدا نمی‌کند. .TP .B 1 اگر نماد پول و رشته علامت در کنار یکدیگر باشند، یک فاصله آن‌ها را از مقدار عددی جدا می‌کند؛ در غیر این صورت، یک فاصله نماد پول و مقدار عددی را جدا می‌سازد. .TP .B 2 اگر نماد پول و رشته علامت در کنار یکدیگر باشند، یک فاصله آن‌ها را از مقدار عددی جدا می‌کند؛ در غیر این صورت، یک فاصله رشته علامت و مقدار عددی را جدا می‌سازد. .RE .TP .I n_cs_precedes به همراه یک عدد صحیح که موقعیت قرارگیری .I currency_symbol را برای مقادیر پولی منفی مشخص می‌کند. مقادیر مشابه با .I p_cs_precedes به رسمیت شناخته می‌شوند. .TP .I n_sep_by_space به همراه یک عدد صحیح که نحوه جداسازی .IR currency_symbol ، رشته علامت و مقدار عددی را برای مقادیر پولی منفی تعیین می‌کند. مقادیر مشابه با .I p_sep_by_space به رسمیت شناخته می‌شوند. .TP .I p_sign_posn به همراه یک عدد صحیح که محل قرارگیری .I positive_sign را برای مقادیر پولی غیرمنفی مشخص می‌سازد: .RS .TP 4 .B 0 پرانتزها کل مقدار عددی و .I currency_symbol یا .I int_curr_symbol را در بر می‌گیرند. .TP .B 1 رشته علامت قبل از مقدار عددی و .I currency_symbol یا .I int_curr_symbol قرار می‌گیرد. .TP .B 2 رشته علامت بعد از مقدار عددی و .I currency_symbol یا .I int_curr_symbol قرار می‌گیرد. .TP .B 3 رشته علامت بلافاصله قبل از .I currency_symbol یا .I int_curr_symbol قرار می‌گیرد. .TP .B 4 رشته علامت بلافاصله بعد از .I currency_symbol یا .I int_curr_symbol قرار می‌گیرد. .RE .TP .I n_sign_posn به همراه یک عدد صحیح که محل قرارگیری .I negative_sign را برای مقادیر پولی منفی مشخص می‌سازد. مقادیر مجاز همانند .I p_sign_posn هستند. .TP .I int_p_cs_precedes به همراه یک عدد صحیح که موقعیت قرارگیری .I int_curr_symbol را برای مقادیر پولی بین‌المللی غیرمنفی مشخص می‌کند. مقادیر مجاز همانند .I p_cs_precedes هستند. .TP .I int_n_cs_precedes به همراه یک عدد صحیح که موقعیت قرارگیری .I int_curr_symbol را برای مقادیر پولی بین‌المللی منفی مشخص می‌کند. مقادیر مجاز همانند .I p_cs_precedes هستند. .TP .I int_p_sep_by_space به همراه یک عدد صحیح که نحوه جداسازی .IR int_curr_symbol ، رشته علامت و مقدار عددی را برای مقادیر پولی بین‌المللی غیرمنفی تعیین می‌کند. مقادیر مجاز همانند .I p_sep_by_space هستند. .TP .I int_n_sep_by_space به همراه یک عدد صحیح که نحوه جداسازی .IR int_curr_symbol ، رشته علامت و مقدار عددی را برای مقادیر پولی بین‌المللی منفی تعیین می‌کند. مقادیر مجاز همانند .I p_sep_by_space هستند. .TP .I int_p_sign_posn به همراه یک عدد صحیح که محل قرارگیری .I positive_sign را برای مقادیر پولی بین‌المللی غیرمنفی تعیین می‌کند. مقادیر مجاز همانند .I p_sign_posn هستند. .TP .I int_n_sign_posn به همراه یک عدد صحیح که محل قرارگیری .I negative_sign را برای مقادیر پولی بین‌المللی منفی تعیین می‌کند. مقادیر مجاز همانند .I p_sign_posn هستند. .PP تعریف .B LC_MONETARY با رشته .IR "END LC_MONETARY" خاتمه می‌یابد. .SS LC_NAME تعریف با عبارت .I LC_NAME در ستون نخست آغاز می‌شود. .PP کلمات کلیدی گوناگونی مجاز هستند، اما تنها .I name_fmt اجباری است. سایر کلمات کلیدی تنها در صورتی مورد نیازند که در این متغیر محلی کاربرد عناوین احترام‌آمیز مربوطه مرسوم باشد. کلمات کلیدی مجاز عبارتند از: .TP .I name_fmt به همراه رشته‌ای شامل توصیف‌گرهای فیلد که قالب به کار رفته برای نام اشخاص را در این متغیر محلی مشخص می‌کند. توصیف‌گرهای زیر به رسمیت شناخته می‌شوند: .RS .TP 4 %f نام خانوادگی (نام‌های خانوادگی). .TP %F نام‌های خانوادگی با حروف بزرگ انگلیسی. .TP %g نام کوچک نخست (نام اصلی). .TP %G حرف نخست نام کوچک. .TP %l نام کوچک نخست با حروف لاتین. .TP %o سایر نام‌های کوتاه‌تر یا مستعار. .TP %m نام‌های کوچک میانی یا تکمیلی. .TP %M حروف نخست نام‌های کوچک میانی یا تکمیلی. .TP %p شغل یا حرفه. .TP %s عنوان احترام‌آمیز، مانند "Doctor" (دکتر). .TP %S مخفف عنوان احترام‌آمیز، مانند ".Mr" یا ".Dr". .TP %d عنوان احترام‌آمیز بر اساس قراردادهای FDCC-sets. .TP %t در صورت خالی بودن مقدار توصیف‌گر قبلی، رشته خالی؛ در غیر این صورت نویسه فاصله درج می‌شود. .RE .TP .I name_gen به همراه عنوان احترام‌آمیز عمومی برای تمام جنسیت‌ها. .TP .I name_mr به همراه عنوان احترام‌آمیز برای آقایان. .TP .I name_mrs به همراه عنوان احترام‌آمیز برای بانوان متأهل. .TP .I name_miss به همراه عنوان احترام‌آمیز برای بانوان مجرد. .TP .I name_ms به همراه عنوان احترام‌آمیز عمومی معتبر برای تمامی بانوان. .PP تعریف .B LC_NAME با رشته .IR "END LC_NAME" خاتمه می‌یابد. .SS LC_NUMERIC تعریف با عبارت .I LC_NUMERIC در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I decimal_point به همراه رشته تک‌نویسه‌ای که به عنوان جداکننده ممیز اعشاری هنگام قالب‌بندی مقادیر عددی استفاده خواهد شد. .TP .I thousands_sep به همراه رشته تک‌نویسه‌ای که به عنوان جداکننده ارقام سه‌تایی هنگام قالب‌بندی مقادیر عددی استفاده می‌شود. .TP .I grouping به همراه دنباله‌ای از اعداد صحیح جداشده با نقطه ویرگول که نحوه گروه‌بندی ارقام مقادیر عددی را مشخص می‌کنند. .IP هر عدد صحیح بیانگر تعداد ارقام موجود در یک گروه است. عدد صحیح نخست اندازه گروهی را مشخص می‌کند که بلافاصله در سمت چپ ممیز اعشاری قرار دارد. اعداد صحیح بعدی گروه‌های متوالی بعدی در سمت چپ گروه قبلی را مشخص می‌کنند. اگر آخرین عدد صحیح .B \-1 نباشد، اندازه گروه قبلی (در صورت وجود) به صورت مکرر برای باقیمانده ارقام اعمال می‌شود. اگر آخرین عدد صحیح .B \-1 باشد، گروه‌بندی دیگری انجام نخواهد شد. .PP تعریف .B LC_NUMERIC با رشته .IR "END LC_NUMERIC" خاتمه می‌یابد. .SS LC_PAPER تعریف با عبارت .I LC_PAPER در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I height به همراه ارتفاع کاغذ استاندارد بر حسب میلی‌متر. .TP .I width به همراه پهنای کاغذ استاندارد بر حسب میلی‌متر. .PP تعریف .B LC_PAPER با رشته .IR "END LC_PAPER" خاتمه می‌یابد. .SS LC_TELEPHONE تعریف با عبارت .I LC_TELEPHONE در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I tel_int_fmt به همراه رشته‌ای شامل توصیف‌گرهای فیلد که قالب به کار رفته برای شماره‌گیری شماره‌های بین‌المللی را مشخص می‌کند. توصیف‌گرهای زیر به رسمیت شناخته می‌شوند: .RS .TP 4 %a پیش‌شماره منطقه بدون پیشوند کشوری (پیشوند معمولاً "00" است). .TP %A پیش‌شماره منطقه به همراه پیشوند کشوری. .TP %l شماره محلی (درون محدوده پیش‌شماره منطقه). .TP %e شماره داخلی (به شماره محلی). .TP %c کد کشور. .TP %C کد اپراتور جایگزین که برای تماس با خارج از کشور استفاده می‌شود. .TP %t در صورت خالی بودن مقدار توصیف‌گر پیشین، رشته خالی؛ در غیر این صورت یک نویسه فاصله درج می‌کند. .RE .TP .I tel_dom_fmt به همراه رشته‌ای شامل توصیف‌گرهای فیلد که قالب به کار رفته برای شماره‌گیری شماره‌های داخلی کشور را مشخص می‌کند. توصیف‌گرهای شناخته‌شده همانند .I tel_int_fmt هستند. .TP .I int_select به همراه پیشوندی که برای برقراری تماس با شماره‌های تلفن بین‌المللی شماره‌گیری می‌شود. .TP .I int_prefix به همراه پیشوندی که از سایر کشورها برای شماره‌گیری این کشور استفاده می‌شود. .PP تعریف .B LC_TELEPHONE با رشته .IR "END LC_TELEPHONE" خاتمه می‌یابد. .SS LC_TIME تعریف با عبارت .I LC_TIME در ستون نخست آغاز می‌شود. .PP کلمات کلیدی مجاز به شرح زیر هستند: .TP .I abday به همراه فهرستی از نام‌های مخفف روزهای هفته. این فهرست با اولین روز هفته همان‌طور که توسط .I week مشخص شده آغاز می‌شود (پیش‌فرض یکشنبه). به بخش نکات (NOTES) مراجعه کنید. .TP .I day به همراه فهرستی از نام‌های کامل روزهای هفته. این فهرست با اولین روز هفته طبق مشخصه .I week آغاز می‌شود (پیش‌فرض یکشنبه). به بخش نکات مراجعه فرمایید. .TP .I abmon به همراه فهرستی از نام‌های مخفف ماه‌های سال. .TP .I mon به همراه فهرستی از نام‌های کامل ماه‌های سال. .TP .I d_t_fmt به همراه قالب مناسب تاریخ و زمان (برای ساختار نحو به .BR strftime (3) مراجعه کنید). .TP .I d_fmt به همراه قالب مناسب نمایش تاریخ (برای ساختار نحو به .BR strftime (3) مراجعه کنید). .TP .I t_fmt به همراه قالب مناسب نمایش زمان (برای ساختار نحو به .BR strftime (3) مراجعه کنید). .TP .I am_pm به همراه نمایش مناسب رشته‌های .B am و .BR pm . برای متغیرهای محلی که از شیوه صبح/عصر (AM/PM) استفاده نمی‌کنند باید خالی گذاشته شود. .TP .I t_fmt_ampm به همراه قالب مناسب زمان هنگام استفاده از قالب ساعت ۱۲ ساعته (برای نحو به .BR strftime (3) مراجعه کنید). این فیلد برای متغیرهای محلی که از AM/PM استفاده نمی‌کنند باید خالی گذاشته شود. .TP .I era به همراه رشته‌های جداشده با نقطه ویرگول که نحوه شمارش و نمایش سال‌ها را برای هر دوره زمانی (مبدأ گاه‌شماری یا era) در متغیر محلی مشخص می‌کند. هر رشته دارای قالب زیر است: .RS .PP .IR direction ":" offset ":" start_date ":" end_date ":" era_name ":" era_format .PP فیلدها به شرح زیر تعریف می‌شوند: .TP 4 .I direction یا .B + یا .BR \- . علامت .B + بدین معناست که سال‌های نزدیک‌تر به .I start_date شماره کمتری نسبت به سال‌های نزدیک‌تر به .I end_date دارند. .B \- به معنای خلاف آن است. .TP .I offset شماره سال نزدیک‌ترین سال به .I start_date در آن دوره، متناظر با توصیف‌گر .I %Ey (به .BR strptime (3) مراجعه کنید). .TP .I start_date آغاز دوره به شکل .IR yyyy/mm/dd . سال‌های پیش از میلاد مسیح (AD 1) با اعداد منفی نشان داده می‌شوند. .TP .I end_date پایان دوره به شکل .IR yyyy/mm/dd ، یا یکی از دو مقدار ویژه .B \-* یا .BR +* . مقدار .B \-* به این معنی است که تاریخ پایان، آغاز زمان است. .B +* بدین معناست که تاریخ پایان، انتهای زمان است. .TP .I era_name نام دوره متناظر با توصیف‌گر .I %EC (به .BR strptime (3) مراجعه کنید). .TP .I era_format قالب سال در دوره متناظر با توصیف‌گر .I %EY (به .BR strptime (3) مراجعه کنید). .RE .TP .I era_d_fmt به همراه قالب تاریخ در نمایش دوره‌ای جایگزین، متناظر با توصیف‌گر .I %Ex (به .BR strptime (3) مراجعه کنید). .TP .I era_t_fmt به همراه قالب زمان در نمایش دوره‌ای جایگزین، متناظر با توصیف‌گر .I %EX (به .BR strptime (3) مراجعه کنید). .TP .I era_d_t_fmt به همراه قالب تاریخ و زمان در نمایش دوره‌ای جایگزین، متناظر با توصیف‌گر .I %Ec (به .BR strptime (3) مراجعه کنید). .TP .I alt_digits به همراه ارقام جایگزین مورداستفاده برای تاریخ و زمان در متغیر محلی. .TP .I week به همراه فهرستی از سه مقدار جداشده با نقطه ویرگول: تعداد روزهای یک هفته (پیش‌فرض ۷)، تاریخی برای آغاز هفته (به طور پیش‌فرض متناظر با یکشنبه)، و حداقل طول هفته نخست سال (به طور پیش‌فرض ۴). با توجه به شروع هفته، مقدار .B 19971130 باید برای یکشنبه و .B 19971201 برای دوشنبه استفاده شود. به بخش نکات مراجعه کنید. .TP .IR first_weekday " (از glibc 2.2)" به همراه شماره روز از فهرست .I day که باید به عنوان نخستین روز هفته در برنامه‌های تقویم نمایش داده شود. مقدار پیش‌فرض .B 1 بسته به مقدار دومین آیتم در فهرست .I week متناظر با یکشنبه یا دوشنبه خواهد بود. به بخش نکات مراجعه فرمایید. .TP .IR first_workday " (از glibc 2.2)" به همراه شماره نخستین روز کاری از فهرست .IR day . مقدار پیش‌فرض .B 2 است. به بخش نکات مراجعه کنید. .TP .I cal_direction به همراه مقداری عددی که جهت نمایش تاریخ‌های تقویم را به شرح زیر مشخص می‌کند: .RS .TP 4 .B 1 چپ به راست از بالا. .TP .B 2 بالا به پایین از چپ. .TP .B 3 راست به چپ از بالا. .RE .TP .I date_fmt به همراه نمایش مناسب تاریخ برای .BR date (1) (برای نحو به .BR strftime (3) مراجعه کنید). .PP تعریف .B LC_TIME با رشته .IR "END LC_TIME" خاتمه می‌یابد. .SH "فایل‌ها (FILES)" .TP .I /usr/lib/locale/locale\-archive محل پیش‌فرض و متداول بایگانی متغیرهای محلی. .TP .I /usr/share/i18n/locales مسیر پیش‌فرض و متداول برای فایل‌های تعریف متغیرهای محلی. .SH "استانداردها (STANDARDS)" POSIX.2. .SH "نکات (NOTES)" دیدگاه و دانش جمعی جامعه توسعه‌دهندگان کتابخانه GNU C در ارتباط با .IR abday ، .IR day ، .IR week ، .IR first_weekday و .I first_workday در نشانی اینترنتی https://sourceware.org/glibc/wiki/Locales به شرح زیر بیان شده است: .IP \[bu] 3 مقدار دومین مورد در فهرست .I week پایه و مبنای فهرست‌های .I abday و .I day را مشخص می‌کند. .IP \[bu] .I first_weekday میزان جابه‌جایی (offset) نخستین روز هفته را در فهرست‌های .I abday و .I day مشخص می‌سازد. .IP \[bu] به دلایل سازگاری، تمام متغیرهای محلی glibc باید مقدار دومین مورد فهرست .I week را برابر با .B 19971130 (یکشنبه) قرار داده و فهرست‌های .I abday و .I day را بر این اساس تنظیم کنند؛ همچنین مقدار .I first_weekday و .I first_workday را بسته به اینکه آغاز هفته و هفته کاری در آن متغیر محلی از یکشنبه یا دوشنبه است، برابر با .B 1 یا .B 2 تنظیم نمایند. .SH "همچنین ببینید (SEE ALSO)" .BR iconv (1), .BR locale (1), .BR localedef (1), .BR localeconv (3), .BR newlocale (3), .BR setlocale (3), .BR strftime (3), .BR strptime (3), .BR uselocale (3), .BR charmap (5), .BR charsets (7), .BR locale (7), .BR unicode (7), .BR utf\-8 (7)