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

مراجعة 08:21، 5 سبتمبر 2018

تكرِّر الدالة repeat()‎ سلسلة المحارف التي استٌدعيت معها عددًا محددًا من المرات.

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

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

المعاملات

`n`

عدد صحيح يمثل عدد مرات تكرار سلسلة المحارف المعطاة. إن أعطيت قيمة سالبة لهذا المعامل، فسيُطلَق الاستثناء IllegalArgumentException.

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

تعاد سلسلة من المحارف تحوي جميع محارف السلسلة المعطاة بعد تكرارها n مرة.

أمثلة

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

fun main(args: Array<String>) {
    println("Word".repeat(4)) // WordWordWordWord
    println("Word".repeat(0)) //
}

مثالٌ آخر على استعمال الدالة ()repeat مع تمرير عدد سالب للمعامل n:

fun main(args: Array<String>) {
    println("Word".repeat(-4))
}

ناتج تنفيذ هذا المثال هو:

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

انظر أيضًا

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

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

مصادر

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

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