الاسم¶

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

المكتبة¶

مكتبة سي المعيارية (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.