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

المراجعة الحالية بتاريخ 10:22، 2 سبتمبر 2018

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

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

actual fun String.capitalize(): String

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

تعاد نسخة من السلسلة النصية المعطاة بعد تحويل الحرف الأول فيها إلى حرف كبير، أو تعاد نسخة أخرى من تلك السلسلة النصية إن كان الحرف الأول فيها حرفًا كبيرًا أو كانت السلسلة فارغةً.

أمثلة

مثالٌ على استعمال الدالة ()capitalize:

fun main(args: Array<String>) {
    println("wiki hsoub".capitalize()) // Wiki hsoub
    println("Wiki hsoub".capitalize()) // Wiki hsoub
}

انظر أيضًا

الدالة decapitalize()‎: تحول الحرف الأول للسلسلة النصية التي استُدعيت معها إلى حرف صغير (lowercase).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.capitalize()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>String.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|قاموس متغير]].
+تعاد نسخة من السلسلة النصية المعطاة بعد تحويل الحرف الأول فيها إلى حرف كبير، أو تعاد نسخة أخرى من تلك السلسلة النصية إن كان الحرف الأول فيها حرفًا كبيرًا أو كانت السلسلة فارغةً.
 ==أمثلة==
-===استخدام الدالة <code>()capitalize</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()capitalize</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <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">
 fun main(args: Array<String>) {
-val str = "hsoub"
+    println("wiki hsoub".capitalize()) // Wiki hsoub
-val map = mutableMapOf<Char, Char>()
+     println("Wiki hsoub".capitalize()) // Wiki 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>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]‎</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+* الدالة <code>[[Kotlin/kotlin.text/decapitalize|decapitalize()‎]]</code>: تحول الحرف الأول [[Kotlin/String|للسلسلة النصية]] التي استُدعيت معها إلى حرف صغير (lowercase).
-* <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[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 صفحة الدالة String.capitalize()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin String]]