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

مراجعة 09:16، 2 سبتمبر 2018

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

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

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).

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.capitalize()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>capitalize()‎</code> نسخة من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، مع جعل الحرف الأول كبيرًا (uppercase).
+تحول الدالة <code>capitalize()‎</code> الحرف الأول [[Kotlin/String|للسلسلة النصية]] التي استُدعيت معها إلى حرف كبير.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 7: / سطر 7: @@
 </syntaxhighlight>
 ==القيم المعادة==
-[[Kotlin/String|سلسلة نصية]].
+تعاد نسخة من السلسلة النصية المعطاة بعد تحويل الحرف الأول فيها إلى حرف كبير، أو تعاد نسخة أخرى من تلك السلسلة النصية إن كان الحرف الأول فيها حرفًا كبيرًا أو كانت السلسلة فارغةً.
 ==أمثلة==
-===استخدام الدالة <code>()capitalize</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()capitalize</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()capitalize</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val str = "hsoub"
+     println("wiki hsoub".capitalize()) // Wiki hsoub
+     println("Wiki hsoub".capitalize()) // Wiki hsoub
-     println(str.capitalize()) // Hsoub
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
 * <code>[[Kotlin/kotlin.text/decapitalize|decapitalize()]]‎</code>:تعيد نسخة من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، مع جعل الحرف الأول صغيرا (lowercase).
@@ سطر 24: / سطر 22: @@
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/capitalize.html الدالة text.capitalize()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/capitalize.html صفحة الدالة capitalize()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]