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

مراجعة 22:31، 11 يوليو 2018

تعيد الدالة repeat()‎ سلسلة حروف جديدة تساوي سلسلة الحروف التي استٌدعيت عبرها مكرّرة n مرة.

في حال كان n سالبا فستطلق الدالة استثناءً IllegalArgumentException.

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

actual fun CharSequence.repeat(n: Int): String

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

سلسلة حروف.

أمثلة

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

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

fun main(args: Array<String>) {
val str = "hsoub" 
    
print( str.repeat (3) ) // hsoubhsoubhsoub
}

استخدام الدالة `()repeat` مع سلسلة نصية: الحالة الثانية

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

fun main(args: Array<String>) {
val str = "hsoub" 
    
print( str.repeat (-3) ) // إطلاق استثناء
}

المُخرجات

Exception in thread "main" java.lang.IllegalArgumentException: Count 'n' must be non-negative, but was -3.
    at kotlin.text.StringsKt__StringsJVMKt.repeat(StringsJVM.kt:436)
    at Simplest_versionKt.main(Simplest version.kt:4)

انظر أيضًا

removeSuffix()‎: إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالة removeSuffix()‎ تنتهي باللاحقة suffix فستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.

compareTo()‎: تقارن بين سلسلتين نصيتين.
asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.repeat()‎</code> في لغة Kotlin}}</noinclude>
-إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>repeat()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.
+تعيد الدالة <code>repeat()‎</code> [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة تساوي [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها مكرّرة <code>n</code>  مرة.
+في حال كان <code>n</code> سالبا فستطلق الدالة استثناءً <code>IllegalArgumentException</code>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.removePrefix(
+actual fun CharSequence.repeat(n: Int): String
-    prefix: CharSequence
-): CharSequence
-</syntaxhighlight>إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removePrefix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد الدالةُ [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.<syntaxhighlight lang="kotlin">
-fun String.removePrefix(prefix: CharSequence): String
-</syntaxhighlight>إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removePrefix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]]  كما هي.
+</syntaxhighlight>
 ==القيم المعادة==
-[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]].
+[[Kotlin/CharSequence/index|سلسلة حروف]].
 ==أمثلة==
 ===استخدام الدالة <code>()repeat</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()repeat</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()repeat</code> عبرها مع تمرير عدد كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+val str = "hsoub"
+print( str.repeat (3) ) // hsoubhsoubhsoub
+}
+</syntaxhighlight>
+===استخدام الدالة <code>()repeat</code> مع سلسلة نصية: الحالة الثانية===
+تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()repeat</code> عبرها مع تمرير عدد سالب كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "hsoub wiki"
+val str = "hsoub"
-print( str.removePrefix ("hsoub ") ) // wiki
+print( str.repeat (-3) ) // إطلاق استثناء
-print( str.removePrefix ("xyz") ) // hsoub wiki
 }
+</syntaxhighlight>المُخرجات<syntaxhighlight lang="kotlin">
+Exception in thread "main" java.lang.IllegalArgumentException: Count 'n' must be non-negative, but was -3.
+    at kotlin.text.StringsKt__StringsJVMKt.repeat(StringsJVM.kt:436)
+    at Simplest_versionKt.main(Simplest version.kt:4)
 </syntaxhighlight>
@@ سطر 31: / سطر 39: @@
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-prefix.html الدالة text.repeat()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/repeat.html الدالة text.repeat()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]