.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, Thomas Koenig .\" Copyright 1999, Bruno Haible .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH setlocale 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم setlocale \- تعيين اللغة المحلية الحالية .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBchar *setlocale(int \fP\fIcategory\fP\fB, const char *_Nullable \fP\fIlocale\fP\fB);\fP .fi .SH الوصف تُستخدم دالة \fBsetlocale\fP() لتعيين أو الاستعلام عن اللغة المحلية الحالية للبرنامج. .P إذا لم يكن \fIlocale\fP فارغًا (NULL)، فتُعدّل اللغة المحلية الحالية للبرنامج وفقًا للمعاملات. يُحدد المعامل \fIcategory\fP أي أجزاء من اللغة المحلية الحالية للبرنامج ينبغي تعديلها. .TS lB lB lB lx. الفئة تتحكم في LC_ALL كل اللغة المحلية LC_ADDRESS T{ تنسيق العناوين و العناصر المتعلقة بالجغرافيا (*) T} LC_COLLATE ترتيب سلاسل المحارف LC_CTYPE تصنيف المحارف LC_IDENTIFICATION T{ البيانات الوصفية التي تصف اللغة المحلية (*) T} LC_MEASUREMENT T{ الإعدادات المتعلقة بالقياسات (الوحدات المترية مقابل الوحدات الأمريكية) (*) T} LC_MESSAGES T{ رسائل اللغة الطبيعية القابلة للتوطين T} LC_MONETARY T{ تنسيق القيم النقدية T} LC_NAME T{ تنسيق التحيات للأشخاص (*) T} LC_NUMERIC T{ تنسيق القيم الرقمية غير النقدية T} LC_PAPER T{ الإعدادات المتعلقة بحجم الورق القياسي (*) T} LC_TELEPHONE T{ التنسيقات المستخدمة مع خدمات الهاتف (*) T} LC_TIME T{ تنسيق قيم التاريخ والوقت T} .TE .P الفئات المميزة بعلامة النجمة في الجدول أعلاه هي امتدادات GNU. لمزيد من المعلومات حول فئات اللغة المحلية هذه، انظر \fBlocale\fP(7). .P الوسيط \fIlocale\fP هو مؤشر لسلسلة محارف تحتوي على الإعداد المطلوب لـ \fIcategory\fP. هذه السلسلة إما ثابت معروف مثل "C" أو "da_DK" (انظر أدناه)، أو سلسلة محارف غير شفافة أُعيدت من استدعاء آخر لـ \fBsetlocale\fP(). .P إذا كان \fIlocale\fP سلسلة محارف فارغة، \fB\[dq]\[dq]\fP، يُضبط كل جزء من الإعداد المحلي الذي ينبغي تعديله وفقًا لمتغيرات البيئة. التفاصيل تعتمد على التطبيق. بالنسبة لـ glibc، أولاً (بغض النظر عن \fIcategory\fP)، يُفحص متغير البيئة \fBLC_ALL\fP، ثم متغير البيئة الذي يحمل نفس اسم الفئة (انظر الجدول أعلاه)، وأخيرًا متغير البيئة \fBLANG\fP. يُستخدم أول متغير بيئة موجود. إذا لم تكن قيمته مواصفة إعداد محلي صالحة، يبقى الإعداد المحلي دون تغيير، وتُعيد \fBsetlocale\fP() قيمة NULL. .P الإعداد المحلي \fB\[dq]C\[dq]\fP أو \fB\[dq]POSIX\[dq]\fP هو إعداد محلي محمول؛ يوجد على جميع الأنظمة المتوافقة. .P اسم الإعداد المحلي عادةً ما يكون بالصيغة \fIlanguage\fP[_\fIterritory\fP][.\fIcodeset\fP][@\fImodifier\fP]، حيث \fIlanguage\fP هو رمز لغة ISO\ 639، و\fIterritory\fP هو رمز دولة ISO\ 3166، و\fIcodeset\fP هو مجموعة محارف أو معرّف ترميز مثل \fBISO\-8859\-1\fP أو \fBUTF\-8\fP. للحصول على قائمة بجميع الإعدادات المحلية المدعومة، جرب "locale \-a" (انظر \fBlocale\fP(1)). .P إذا كان \fIlocale\fP هو NULL، يُستعلم عن الإعداد المحلي الحالي فقط، دون تعديل. .P عند بدء تشغيل البرنامج الرئيس، يُختار الإعداد المحلي المحمول \fB\[dq]C\[dq]\fP كمبدئي. يمكن جعل البرنامج محمولاً لجميع الإعدادات المحلية باستدعاء: .P .in +4n .EX setlocale(LC_ALL, ""); .EE .in .P بعد تهيئة البرنامج، ثم: .IP \[bu] 3 باستخدام القيم المُعادة من استدعاء \fBlocaleconv\fP(3) للمعلومات المعتمدة على الإعداد المحلي؛ .IP \[bu] باستخدام دوال المحارف متعددة البايت والمحارف العريضة لمعالجة النص إذا كان \fBMB_CUR_MAX > 1\fP؛ .IP \[bu] باستخدام \fBstrcoll\fP(3) و \fBstrxfrm\fP(3) لمقارنة السلاسل؛ و .IP \[bu] باستخدام \fBwcscoll\fP(3) و \fBwcsxfrm\fP(3) لمقارنة سلاسل المحارف العريضة. .SH "قيمة الإرجاع" استدعاء ناجح لـ \fBsetlocale\fP() يُعيد سلسلة محارف غير شفافة تتوافق مع الإعداد المحلي المُضبط. قد تُخصص هذه السلسلة في تخزين ثابت. السلسلة المُعادة تكون بحيث أن استدعاءً لاحقًا بتلك السلسلة وفئتها المرتبطة سيستعيد ذلك الجزء من الإعداد المحلي للعملية. قيمة الإرجاع هي NULL إذا تعذر تلبية الطلب. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBsetlocale\fP() T} سلامة الخيوط MT\-Unsafe const:locale env .TE .SH المعايير C11, POSIX.1\-2008. .SS الفئات .TP \fBLC_ALL\fP .TQ \fBLC_COLLATE\fP .TQ \fBLC_CTYPE\fP .TQ \fBLC_MONETARY\fP .TQ \fBLC_NUMERIC\fP .TQ \fBLC_TIME\fP C11, POSIX.1\-2008. .TP \fBLC_MESSAGES\fP POSIX.1\-2008. .TP أخرى: GNU. .SH التاريخ POSIX.1\-2001، C89. .SS الفئات .TP \fBLC_ALL\fP .TQ \fBLC_COLLATE\fP .TQ \fBLC_CTYPE\fP .TQ \fBLC_MONETARY\fP .TQ \fBLC_NUMERIC\fP .TQ \fBLC_TIME\fP C89, POSIX.1\-2001. .TP \fBLC_MESSAGES\fP POSIX.1\-2001. .TP أخرى: GNU. .SH "انظر أيضًا" \fBlocale\fP(1), \fBlocaledef\fP(1), \fBisalpha\fP(3), \fBlocaleconv\fP(3), \fBnl_langinfo\fP(3), \fBrpmatch\fP(3), \fBstrcoll\fP(3), \fBstrftime\fP(3), \fBcharsets\fP(7), \fBlocale\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .