.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2001, Markus Kuhn .\" Copyright 2006, Michael Kerrisk .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH nl_langinfo 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم nl_langinfo, nl_langinfo_l \- استعلام معلومات اللغة والإعدادات المحلية .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBchar *nl_langinfo(nl_item \fP\fIitem\fP\fB);\fP \fBchar *nl_langinfo_l(nl_item \fP\fIitem\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBnl_langinfo_l\fP(): .nf منذ glibc 2.24: _POSIX_C_SOURCE >= 200809L glibc 2.23 وما قبله: _POSIX_C_SOURCE >= 200112L .fi .SH الوصف توفر الدالتان \fBnl_langinfo\fP() و \fBnl_langinfo_l\fP() وصولاً إلى معلومات الإعدادات المحلية بطريقة أكثر مرونة من \fBlocaleconv\fP(3). تُرجع \fBnl_langinfo\fP() سلسلة محارف تمثل القيمة المقابلة لـ \fIitem\fP في الإعدادات المحلية العامة الحالية للبرنامج. تُرجع \fBnl_langinfo_l\fP() سلسلة محارف تمثل القيمة المقابلة لـ \fIitem\fP للإعدادات المحلية المحددة بواسطة كائن الإعدادات المحلية \fIlocale\fP، الذي أُنشئ سابقًا بواسطة \fBnewlocale\fP(3). يمكن الاستعلام عن العناصر الفردية والإضافية لفئات الإعدادات المحلية. .P أمثلة على عناصر الإعدادات المحلية التي يمكن تحديدها في \fIitem\fP باستخدام الثوابت المعرفة في \fI\fP هي: .TP \fBCODESET\fP\ (LC_CTYPE) تُرجع سلسلة محارف تحتوي على اسم ترميز الأحرف المستخدم في الإعدادات المحلية المحددة، مثل "UTF\-8" أو "ISO\-8859\-1" أو "ANSI_X3.4\-1968" (المعروف باسم US\-ASCII). هذه هي نفس السلسلة التي تحصل عليها باستخدام "locale charmap". للحصول على قائمة بأسماء ترميز الأحرف، جرب "locale \-m" (انظر \fBlocale\fP(1)). .TP \fBD_T_FMT\fP\ (LC_TIME) تُرجع سلسلة محارف يمكن استخدامها كسلسلة تنسيق لـ \fBstrftime\fP(3) لتمثيل الوقت والتاريخ بطريقة خاصة بالإعدادات المحلية (مواصفات التحويل \fB%c\fP). .TP \fBD_FMT\fP\ (LC_TIME) تُرجع سلسلة محارف يمكن استخدامها كسلسلة تنسيق لـ \fBstrftime\fP(3) لتمثيل التاريخ بطريقة خاصة بالإعدادات المحلية (مواصفات التحويل \fB%x\fP). .TP \fBT_FMT\fP\ (LC_TIME) تُرجع سلسلة محارف يمكن استخدامها كسلسلة تنسيق لـ \fBstrftime\fP(3) لتمثيل الوقت بطريقة خاصة بالإعدادات المحلية (مواصفات التحويل \fB%X\fP). .TP \fBAM_STR\fP\ (LC_TIME) تُرجع سلسلة محارف تمثل لاحقة لوقت ما قبل الظهر (قبل منتصف النهار، "AM"). (تُستخدم في مواصفات التحويل \fB%p\fP لـ \fBstrftime\fP(3).) .TP \fBPM_STR\fP\ (LC_TIME) تُرجع سلسلة محارف تمثل لاحقة لوقت ما بعد الظهر (قبل منتصف الليل، "PM"). (تُستخدم في مواصفات التحويل \fB%p\fP لـ \fBstrftime\fP(3).) .TP \fBT_FMT_AMPM\fP\ (LC_TIME) أرجع سلسلة محارف يمكن استخدامها كسلسلة تنسيق للدالة \fBstrftime\fP(3) لتمثيل وقت بترميز صباحًا أو مساءً بطريقة خاصة بالمحل (مواصفة التحويل \fB%r\fP). .TP \fBERA\fP\ (LC_TIME) أرجع وصف العصر، الذي يحتوي على معلومات حول كيفية حساب السنوات وعرضها لكل عصر في محل. يجب أن يكون لكل مقطع وصف عصر التنسيق: .RS .IP \fIdirection\fP:\fIoffset\fP:\fIstart_date\fP:\fIend_date\fP:\fIera_name\fP:\fIera_format\fP .RE .IP وفقًا للتعريفات أدناه: .RS .TP 12 \fIdirection\fP إما حرف \[dq]\fB+\fP\[dq] أو \[dq]\fB\-\fP\[dq]. يعني \[dq]\fB+\fP\[dq] أن السنوات تزداد من \fIstart_date\fP نحو \fIend_date\fP، ويعني \[dq]\fB\-\fP\[dq] العكس. .TP \fIoffset\fP سنة الحقبة لـ \fIstart_date\fP. .TP \fIstart_date\fP تاريخ بالصيغة \fIyyyy\fP/\fImm\fP/\fIdd\fP، حيث \fIyyyy\fP و\fImm\fP و\fIdd\fP هي أرقام السنة والشهر واليوم على التوالي لبداية العصر. .TP \fIend_date\fP تاريخ نهاية العصر، بنفس تنسيق \fIstart_date\fP، أو إحدى القيمتين الخاصتين \[dq]\fB\-*\fP\[dq] (ناقص لانهاية) أو \[dq]\fB+*\fP\[dq] (زائد لانهاية). .TP \fIera_name\fP اسم العصر، الموافق لمواصفة التحويل \fB%EC\fP في \fBstrftime\fP(3). .TP \fIera_format\fP تنسيق السنة في العصر، الموافق لمواصفة التحويل \fB%EY\fP في \fBstrftime\fP(3). .RE .IP تُفصل مقاطع وصف العصر بفواصل منقوطة. معظم المحلات لا تعرف هذه القيمة. أمثلة على المحلات التي تعرف هذه القيمة هي المحلات اليابانية والتايلاندية. .TP \fBERA_D_T_FMT\fP\ (LC_TIME) أرجع سلسلة محارف يمكن استخدامها كسلسلة تنسيق للدالة \fBstrftime\fP(3) لتمثيل بديل للوقت والتاريخ بطريقة خاصة بالمحل (مواصفة التحويل \fB%Ec\fP). .TP \fBERA_D_FMT\fP\ (LC_TIME) أرجع سلسلة محارف يمكن استخدامها كسلسلة تنسيق للدالة \fBstrftime\fP(3) لتمثيل بديل لتاريخ بطريقة خاصة بالمحل (مواصفة التحويل \fB%Ex\fP). .TP \fBERA_T_FMT\fP\ (LC_TIME) أرجع سلسلة محارف يمكن استخدامها كسلسلة تنسيق للدالة \fBstrftime\fP(3) لتمثيل بديل لوقت بطريقة خاصة بالمحل (مواصفة التحويل \fB%EX\fP). .TP \fBDAY_\fP{1\[en]7} (LC_TIME) أرجع اسم اليوم \fIn\fP من الأسبوع. [تحذير: هذا يتبع اصطلاح الولايات المتحدة DAY_1 = الأحد، وليس الاصطلاح الدولي (ISO\ 8601) بأن الاثنين هو أول يوم في الأسبوع.] (مُستخدم في مواصفة التحويل \fB%A\fP في \fBstrftime\fP(3).) .TP \fBABDAY_\fP{1\[en]7} (LC_TIME) أعد الاسم المختصر لليوم \fIn\fP من الأسبوع. (مُستخدم في مواصفات تحويل \fB%a\fP \fBstrftime\fP(3).) .TP \fBMON_\fP{1\[en]12} (LC_TIME) أعد اسم الشهر \fIn\fP. (مُستخدم في مواصفات تحويل \fB%B\fP \fBstrftime\fP(3).) .TP \fBABMON_\fP{1\[en]12} (LC_TIME) أعد الاسم المختصر للشهر \fIn\fP. (مُستخدم في مواصفات تحويل \fB%b\fP \fBstrftime\fP(3).) .TP \fBRADIXCHAR\fP\ (LC_NUMERIC) أعد حرف الجذر (نقطة عشرية، فاصلة عشرية، إلخ). .TP \fBTHOUSEP\fP\ (LC_NUMERIC) أعد حرف الفاصل للآلاف (مجموعات من ثلاثة أرقام). .TP \fBYESEXPR\fP\ (LC_MESSAGES) أعد تعبيرًا نمطيًا يمكن استخدامه مع دالة \fBregex\fP(3) للتعرف على استجابة إيجابية لسؤال نعم/لا. .TP \fBNOEXPR\fP\ (LC_MESSAGES) أعد تعبيرًا نمطيًا يمكن استخدامه مع دالة \fBregex\fP(3) للتعرف على استجابة سلبية لسؤال نعم/لا. .TP \fBCRNCYSTR\fP\ (LC_MONETARY) أعد رمز العملة، مسبوقًا بـ "\-" إذا كان الرمز يجب أن يظهر قبل القيمة، أو "+" إذا كان الرمز يجب أن يظهر بعد القيمة، أو "." إذا كان الرمز يجب أن يستبدل حرف الجذر. .P تغطي القائمة أعلاه بعض الأمثلة فقط من العناصر التي يمكن طلبها. للحصول على قائمة أكثر تفصيلاً، راجع \fIدليل مكتبة C لجنو\fP. .SH "قيمة الإرجاع" عند النجاح، تُعيد هذه الدوال مؤشرًا إلى سلسلة محارف وهي القيمة المقابلة لـ \fIitem\fP في الإعدادات المحلية المحددة. .P إذا لم تُحدد إعدادات محلية بواسطة \fBsetlocale\fP(3) للفئة المناسبة، تُعيد \fBnl_langinfo\fP() مؤشرًا إلى السلسلة المقابلة في الإعدادات المحلية "C". وينطبق نفس الشيء على \fBnl_langinfo_l\fP() إذا حدد \fIlocale\fP إعدادات محلية حيث بيانات \fIlanginfo\fP غير مُعرَّفة. .P إذا كان \fIitem\fP غير صالح، يُعاد مؤشر إلى سلسلة محارف فارغة. .P قد يشير المؤشر الذي تُعيده هذه الدوال إلى بيانات ثابتة قد تُستبدل، أو قد يُبطل المؤشر نفسه، باستدعاء لاحق لـ \fBnl_langinfo\fP() أو \fBnl_langinfo_l\fP() أو \fBsetlocale\fP(3). تنطبق نفس العبارات على \fBnl_langinfo_l\fP() إذا تم تحرير أو تعديل كائن الإعدادات المحلية المشار إليه بواسطة \fIlocale\fP بواسطة \fBfreelocale\fP(3) أو \fBnewlocale\fP(3). .P تُحدد POSIX أن التطبيق قد لا يُعدّل السلسلة المحارف المُعادة من هذه الدوال. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBnl_langinfo\fP() T} سلامة الخيوط المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe) .TE .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001, SUSv2. .SH ملاحظات سلوك \fBnl_langinfo_l\fP() غير مُحدد إذا كان \fIlocale\fP هو كائن اللغة الخاص \fBLC_GLOBAL_LOCALE\fP أو ليس مقبض كائن لغة صالح. .SH أمثلة يُعيِّن البرنامج التالي نوع المحرف واللغة الرقمية وفقًا للبيئة ويستعلم عن مجموعة محارف الطرفية ومحرف الجذر. .P .\" SRC BEGIN (nl_langinfo.c) .EX #include #include #include #include \& int main(void) { setlocale(LC_CTYPE, ""); setlocale(LC_NUMERIC, ""); \& printf("%s\[rs]n", nl_langinfo(CODESET)); printf("%s\[rs]n", nl_langinfo(RADIXCHAR)); \& exit(EXIT_SUCCESS); } .EE .\" SRC END .SH "انظر أيضًا" \fBlocale\fP(1), \fBlocaleconv\fP(3), \fBsetlocale\fP(3), \fBcharsets\fP(7), \fBlocale\fP(7) .P دليل مكتبة GNU C المرجعي .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .