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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.repeat()‎</code> في لغة Kotlin}}</noinclude> إن كانت السلسلة النصية أو [...')
 
ط
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE: الدالة <code>text.repeat()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.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|سلسلة المحارف]] التي استٌدعيت معها عددًا محددًا من المرات.  
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<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>
 +
 
 +
== المعاملات ==
 +
 
 +
=== <code>n</code> ===
 +
عدد صحيح يمثل عدد مرات تكرار [[Kotlin/CharSequence/index|سلسلة المحارف]] المعطاة. إن أعطيت قيمة سالبة لهذا المعامل، فسيُطلَق الاستثناء <code>IllegalArgumentException</code>.
  
 
==القيم المعادة==
 
==القيم المعادة==
−
[[Kotlin/String|سلسلة نصية]] أو [[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> عبرها مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+
fun main(args: Array<String>) {
 +
    println("Word".repeat(4)) // WordWordWordWord
 +
    println("Word".repeat(0)) //
 +
}
 +
</syntaxhighlight>مثالٌ آخر على استعمال الدالة <code>()repeat</code> مع تمرير عدد سالب للمعامل <code>n</code>:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
−
val str = "hsoub wiki"
+
     println("Word".repeat(-4))
−
      
 
−
print( str.removePrefix ("hsoub ") ) // wiki
 
−
print( str.removePrefix ("xyz") ) // hsoub wiki
 
 
}
 
}
 +
</syntaxhighlight>ناتج تنفيذ هذا المثال هو:<syntaxhighlight lang="text">
 +
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)
 
</syntaxhighlight>
 
</syntaxhighlight>
−
 
+
==انظر أيضًا==
−
== انظر أيضًا ==
+
* الدالة <code>[[Kotlin/kotlin.text/replace|replace()‎]]</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/padEnd|padEnd()]]‎</code>: تحشو نهاية سلسلة نصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.
−
 
+
* الدالة <code>[[Kotlin/kotlin.text/removeSurrounding|removeSurrounding()‎]]</code>: تحذف بادئة ولاحقة محددتين من <nowiki/>[[Kotlin/CharSequence|سلسلة من المحارف]] أو سلسلة نصية.  
−
* <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/remove-prefix.html الدالة text.repeat()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/repeat.html صفحة الدالة CharSequence.repeat()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
−
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 10:47، 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)

انظر أيضًا

  • الدالة replace()‎: تبدل محرفًا جديدًا مكان محرف قديم، أو سلسلة نصية جديدة مكان سلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان كل ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف.
  • الدالة padEnd()‎: تحشو نهاية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.
  • الدالة removeSurrounding()‎: تحذف بادئة ولاحقة محددتين من سلسلة من المحارف أو سلسلة نصية.  

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/repeat&oldid=16600"