Kotlin/text/toUpperCase

تحوّل الدالة toUpperCase()‎ الحرف أو جميع حروف السلسلة النصية التي استٌدعيت معها إلى حروف كبيرة (uppercase).

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

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

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

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

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

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

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

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

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

أمثلة

استعمال الدالة toUpperCase()‎ لتحويل جميع حروف سلسلة نصية إلى حروف كبيرة:

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

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

import java.util.Locale

fun main(args: Array<String>) {    
    println("i".toUpperCase(Locale("tr"))) // İ
}

انظر أيضًا

• الدالة toLowerCase()‎: تحوّل الحرف أو جميع حروف السلسلة النصية التي استٌدعيت معها إلى حروف صغيرة (lowercase).
• الدالة toTitleCase()‎ : تحوّل المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase).
• الدالة isLetter()‎: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
• الدالة isUpperCase()‎: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case).

مصادر

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