Kotlin/text/toLowerCase

تحوّل الدالة toLowerCase()‎ الحرف أو جميع حروف السلسلة النصية التي استٌدعيت معها إلى حروف صغيرة (lowercase).

البنية العامة

inline actual fun Char.toLowerCase(): Char
inline actual fun String.toLowerCase(): String

يمكن استدعاء الدالة toLowerCase()‎ مع حرف، ومع سلسلة نصية.

inline fun String.toLowerCase(locale: Locale): String

المنصة المطلوبة: JVM.

يمكن أيضًا استدعاء الدالة مع سلسلة نصية ومع تمرير الوسيط locale الذي يضبط المحلية إلى المنطقة الجغرافية الحالية المطلوبة.

وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)).

القيم المعادة

يعاد الحرف Char المعطى بعد تحويله إلى حروف صغير، أو السلسلة النصية String المعطاة بعد تحويل جميع حروفها إلى حروفٍ صغيرة.

أمثلة

استعمال الدالة toLowerCase()‎ لتحويل حروف سلسلة نصية إلى حروف صغيرة:

fun main(args: Array<String>) {    
    val x = "HSOUB"
    
    print(x.toLowerCase()) // hsoub
}

استعمال الدالة toLowerCase()‎ لتحويل الحرف I إلى حرف صغير مع تمرير الوسيط Locale("tr")‎ الذي يضبط المحلية إلى اللغة التركية:

import java.util.Locale

fun main(args: Array<String>) {  
    println("I".toLowerCase(Locale("tr"))) // ı
}

انظر أيضًا

• الدالة toTitleCase()‎ : تحوّل المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase).
• الدالة toUpperCase()‎ : تحوّل الحرف أو جميع حروف السلسلة النصية التي استٌدعيت معها إلى حروف كبيرة (uppercase).
• الدالة isLetter()‎: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
• الدالة isLowerCase()‎: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case).
• الدالة plus()‎: تضيف الحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.

مصادر

• صفحة الدالة toLowerCase()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.