الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/capitalize»

مراجعة 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 والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

الدالة text.capitalize()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <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">
-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>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>) {
-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>
@@ سطر 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 Functions]]