towupper(3)

الاسم
towupper, towupper_l - تحويل محرف عريض إلى حرف كبير

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

موجز
#include <wctype.h>

wint_t towupper(wint_t wc);
wint_t towupper_l(wint_t wc, locale_t locale);

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

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

الوصف
الدالة towupper() هي المكافئ للمحرف العريض للدالة toupper(3). إذا كان wc محرفًا عريضًا صغيرًا، وكان هناك مقابل كبير في اللغة الحالية، فإنها تُرجع المقابل الكبير لـ wc. في جميع الحالات الأخرى، يُعاد wc دون تغيير.

الدالة towupper_l() تؤدي نفس المهمة، لكنها تُجري التحويل بناءً على معلومات نوع المحرف في اللغة المحددة بواسطة locale. سلوك towupper_l() غير مُعرّف إذا كان locale هو كائن اللغة الخاص LC_GLOBAL_LOCALE (انظر duplocale(3)) أو لم يكن مقبض كائن لغة صالحًا.

يجب أن يكون المعامل wc قابلاً للتمثيل كـ wchar_t ومحرفًا صالحًا في المحلية أو يكون القيمة WEOF.

قيمة الإرجاع
إذا كان wc قابلًا للتحويل إلى كبير، تُرجع towupper() مقابله الكبير؛ وإلا تُرجع wc.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
towupper() | سلامة الخيوط | المنطقة (locale) آمنة لتعدد المسالك (MT-Safe)
towupper_l() | سلامة الخيوط | MT-Safe

المعايير

towupper()
    C11، POSIX.1-2008 (XSI).

towupper_l()
    POSIX.1-2008.

التاريخ

towupper()
    C99, POSIX.1-2001 (XSI). مهجور في POSIX.1-2008 (XSI).

towupper_l()
    POSIX.1-2008. glibc 2.3.

ملاحظات
يعتمد سلوك هذه الدوال على فئة LC_CTYPE للمحلية.

هذه الدوال ليست مناسبة جدًا للتعامل مع محارف يونيكود، لأن يونيكود يعرف ثلاث حالات: حالة الأحرف الكبيرة، والصغيرة، وحالة العنوان.

انظر أيضًا
iswupper(3), towctrans(3), towlower(3), locale(7)

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

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

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