الاسم

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

#include <locale.h>

locale_t duplocale(locale_t locobj);

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 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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