towlower(3)

الاسم
towlower, towlower_l - تحويل محرف عريض إلى حرف صغير

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

موجز
#include <wctype.h>

wint_t towlower(wint_t wc);
wint_t towlower_l(wint_t wc, locale_t locale);

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

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

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

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

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

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

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

المعايير

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

towlower_l()
    POSIX.1-2008.

المعايير

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

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

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

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

انظر أيضًا
iswlower(3), towctrans(3), towupper(3), locale(7)

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

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

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