الدالة toUpperCase()‎ في Kotlin

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

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

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

inline actual fun Char.toUpperCase(): Char
inline actual fun String.toUpperCase(): String 
inline fun String.toUpperCase(locale: Locale): String
المنصة المطلوبة: JVM.

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

المعاملات

locale

المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل.

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

يعاد المحرف 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"))) // İ
}

انظر أيضًا

  • الدالة toFloat(): تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
  • الدالة toHashSet(): تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
  • الدالة toInt(): تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
  • الدالة toSet(): تضيف كل محارف سلسلة الحروف  التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.
  • الدالة toShort(): تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير.
  • الدالة toSortedSet(): تضيف كل محارف السلسلة  التي استٌدعيت معها إلى مجموعة من النوع SortedSet، إذ يوضع كل محرف في عنصر.
  • الدالة toString() : تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية.
  • الدالة toTitleCase(): تحول المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل 'Dž' أو 'Nj'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
  • الدالة isUpperCase(): تتحقق إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case).

مصادر