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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.capitalize()‎</code> في لغة Kotlin}}</noinclude> تملأ الدالة <code>capitalize()‎</code> Kotlin/Mu...')
 
(مراجعة وتدقيق.)
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 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">
 
<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>) {
 
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>
 
</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]]
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin String]]

المراجعة الحالية بتاريخ 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
}

انظر أيضًا

مصادر