uselocale(3)

الاسم
uselocale - تعيين/الحصول على المحلية للخيط المستدعي

المكتبة
مكتبة سي المعيارية (libc، -lc)

موجز
#include <locale.h>

locale_t uselocale(locale_t newloc);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

uselocale():
    منذ glibc 2.10:
        _XOPEN_SOURCE >= 700
    قبل glibc 2.10:
        _GNU_SOURCE

الوصف
تضبط الدالة uselocale() المحلية الحالية للخيط المستدعي، وتُعيد المحلية السابقة للخيط. بعد استدعاء ناجح لـ uselocale()، تعمل أي استدعاءات من هذا الخيط لدوال تعتمد على المحلية كما لو أن المحلية ضُبطت إلى newloc.

يمكن أن يأخذ المعامل newloc إحدى القيم التالية:

مُعالَج يُعاد من استدعاء لـ
    newlocale(3) أو duplocale(3) تُضبط المحلية الحالية للخيط المستدعي إلى المحلية المحددة.

مُعالَج كائن المحلية الخاص
    LC_GLOBAL_LOCALE تُضبط المحلية الحالية للخيط المستدعي إلى المحلية العامة المحددة بواسطة setlocale(3).

(locale_t) 0
    تُترك المحلية الحالية للخيط المستدعي دون تغيير (وتُعاد المحلية الحالية كنتيجة للدالة).

قيمة الإرجاع
عند النجاح، تُعيد uselocale() مُعالَج المحلية الذي ضُبط بواسطة الاستدعاء السابق لـ uselocale() في هذا الخيط، أو LC_GLOBAL_LOCALE إذا لم يكن هناك استدعاء سابق. عند الخطأ، تُعيد (locale_t) 0، وتضبط errno للإشارة إلى الخطأ.

الأخطاء

EINVAL
    لا يشير newloc إلى كائن محلية صالح.

المعايير
POSIX.1-2008.

التاريخ
glibc 2.3. POSIX.1-2008.

ملاحظات
على عكس setlocale(3)، لا تسمح uselocale() بالاستبدال الانتقائي لفئات المحلية الفردية. لاستخدام محلية تختلف في فئات قليلة فقط عن المحلية الحالية، استخدم استدعاءات لـ duplocale(3) و newlocale(3) للحصول على كائن محلية مكافئ للمحلية الحالية وتعديل الفئات المطلوبة في ذلك الكائن.

أمثلة
انظر newlocale(3) و duplocale(3).

انظر أيضًا
locale(1), duplocale(3), freelocale(3), newlocale(3), setlocale(3), locale(5), locale(7)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.