duplocale(3)

الاسم
duplocale - نسخ كائن محلي

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

موجز
#include <locale.h>

locale_t duplocale(locale_t locobj);

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

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

الوصف
الدالة duplocale() تنشئ نسخة من الكائن المحلي المشار إليه بـ locobj.

إذا كان locobj هو LC_GLOBAL_LOCALE، فإن duplocale() تنشئ كائنًا محليًا يحتوي على نسخة من المحلية العامة المحددة بواسطة setlocale(3).

قيمة الإرجاع
عند النجاح، تُرجع duplocale() مقبضًا للكائن المحلي الجديد. عند الخطأ، تُرجع (locale_t) 0، وتضبط errno للإشارة إلى الخطأ.

الأخطاء

ENOMEM
    ذاكرة غير كافية لإنشاء نسخة الكائن المحلي.

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

التاريخ
glibc 2.3.

ملاحظات
يمكن أن يخدم نسخ محلية الأغراض التالية:

•   لإنشاء نسخة من كائن محلي سيتم تعديل فئة أو أكثر فيه (باستخدام newlocale(3)).

•   للحصول على مقبض للمحلية الحالية الذي يمكن استخدامه في دوال أخرى تستخدم مقبض محلية، مثل toupper_l(3). يتم ذلك بتطبيق duplocale() على القيمة المُرجعة من الاستدعاء التالي:

        loc = uselocale((locale_t) 0);

    هذه التقنية ضرورية، لأن استدعاء uselocale(3) أعلاه قد يُرجع القيمة LC_GLOBAL_LOCALE، مما يؤدي إلى سلوك غير محدد إذا تم تمريره إلى دوال مثل toupper_l(3). يمكن استخدام استدعاء duplocale() لضمان تحويل قيمة LC_GLOBAL_LOCALE إلى كائن محلي قابل للاستخدام. انظر الأمثلة أدناه.

يجب تحرير كل كائن محلي تم إنشاؤه بواسطة duplocale() باستخدام freelocale(3).

أمثلة
البرنامج أدناه يستخدم uselocale(3) و duplocale() للحصول على مقبض للمحلية الحالية الذي يُمرر بعد ذلك إلى toupper_l(3). يأخذ البرنامج وسيطًا واحدًا من سطر الأوامر، سلسلة محارف تُحوَّل إلى أحرف كبيرة وتُعرض على المخرجات القياسية. مثال على استخدامه هو التالي:

    $ ./a.out abc;
    ABC

  مصدر البرنامج
    #define _XOPEN_SOURCE 700
    #include <ctype.h>
    #include <err.h>
    #include <locale.h>
    #include <stdio.h>
    #include <stdlib.h>

    int
    main(int argc, char *argv[])
    {
        locale_t loc, nloc;

        if (argc != 2) {
            fprintf(stderr, "Usage: %s string\n", argv[0]);
            exit(EXIT_FAILURE);
        }

        /* This sequence is necessary, because uselocale() might return
           the value LC_GLOBAL_LOCALE, which can't be passed as an
           argument to toupper_l().  */

        loc = uselocale((locale_t) 0);
        if (loc == (locale_t) 0)
            err(EXIT_FAILURE, "uselocale");

        nloc = duplocale(loc);
        if (nloc == (locale_t) 0)
            err(EXIT_FAILURE, "duplocale");

        for (char *p = argv[1]; *p; p++)
            putchar(toupper_l(*p, nloc));

        printf("\n");

        freelocale(nloc);

        exit(EXIT_SUCCESS);
    }

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

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

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

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