الفرق بين المراجعتين ل"Kotlin/kotlin.text/capitalize"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.capitalize()‎</code> في لغة Kotlin}}</noinclude> تملأ الدالة <code>capitalize()‎</code> Kotlin/Mu...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>text.capitalize()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>text.capitalize()‎</code> في لغة Kotlin}}</noinclude>
تملأ الدالة <code>capitalize()‎</code> [[Kotlin/MutableMap|القاموس المتغير]] <code>destination</code>  بأزواج من "مفتاح/قيمة"،  حيث القيمة هي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>transform</code>.
+
تعيد الدالة <code>capitalize()‎</code> نسخة من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، مع جعل الحرف الأول كبيرًا (uppercase).  
 
 
إن كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة <code>keySelector</code>، فإنَّ الأخير هو الذي سيُضاف إلى القاموس.  
 
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
inline fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateTo(
+
actual fun String.capitalize(): String
    destination: M,
+
 
    transform: (Char) -> Pair<K, V>
+
</syntaxhighlight>
): M
 
</syntaxhighlight>يلاحظ وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
 
 
==القيم المعادة==
 
==القيم المعادة==
[[Kotlin/MutableMap|قاموس متغير]].
+
[[Kotlin/String|سلسلة نصية]].  
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>()capitalize</code> مع سلسلة نصية===
 
===استخدام الدالة <code>()capitalize</code> مع سلسلة نصية===
تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تنشئ  [[Kotlin/MutableMap|قاموسا متغيرا]] باسم <code>map،</code> ثم تمرّر الدالة <code>()func</code> (التي تحول الحرف إلى زوج مكون من الحرف في الحالة الكبيرة UpperCase والحالة الصغيرة LowerCase) و<nowiki/>[[Kotlin/MutableMap|القاموس المتغير]] <code>map</code> إلى <code>()capitalize</code>، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة <code>()capitalize</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
val str = "hsoub"
+
    val str = "hsoub"
val map = mutableMapOf<Char, Char>()
+
 
      
+
     println(str.capitalize()) // Hsoub
val func: (Char) -> Pair<Char, Char> = {
 
    Pair(it.toUpperCase(), it.toLowerCase())
 
}
 
   
 
str.associateTo(map,func)  
 
println(map) // {H=h, S=s, O=o, U=u, B=b}
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
سطر 34: سطر 24:
  
 
==مصادر==
 
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/associate-to.html الدالة text.capitalize()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/capitalize.html الدالة text.capitalize()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 19:15، 7 يوليو 2018

تعيد الدالة capitalize()‎ نسخة من السلسلة النصية التي استُدعيت عبرها، مع جعل الحرف الأول كبيرًا (uppercase).

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

actual fun String.capitalize(): String

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

سلسلة نصية.

أمثلة

استخدام الدالة ()capitalize مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()capitalize عبرها، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
    val str = "hsoub"

    println(str.capitalize()) // Hsoub 
}

انظر أيضًا

  • associateBy(): تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة keySelector.
  • associateByTo(): تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة keySelector
  • asSequence(): تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر