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

مراجعة 17:19، 8 يوليو 2018

تعيد الدالة drop()‎ جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف أول n حرفًا.

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

fun CharSequence.drop(n: Int): CharSequence 

fun String.drop(n: Int): String

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

سلسلة نصية أو سلسلة حروف.

أمثلة

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

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

fun main(args: Array<String>) {
val str = "wiki Hsoub" 
    
println(str.drop(0)) // wiki Hsoub
println(str.drop(2)) // ki Hsoub
println(str.drop(5)) // Hsoub
println(str.drop(8)) // ub
}

انظر أيضًا

contains()‎: تعيد القيمة true إن كانت سلسلة الحروف التي استُدعيت عبرها تحتوي الحرف أو سلسلة الحروف المُمرّرة. الوسيطignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.drop()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>drop()‎</code> عدد حروف [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> فستعيد عدد الحروف التي تحقق تلك الدالة المنطقية.
+تعيد الدالة <code>drop()‎</code> جزءًا من [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مع حذف أول <code>n</code> حرفًا.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun CharSequence.count(): Int
+fun CharSequence.drop(n: Int): CharSequence
-inline fun CharSequence.count(
+fun String.drop(n: Int): String
-    predicate: (Char) -> Boolean
-): Int
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>
 ==القيم المعادة==
-عدد من النوع <code>Int</code>.
+[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]].
 ==أمثلة==
-===استخدام الدالة <code>()count</code> مع سلسلة نصية===
+===استخدام الدالة <code>()drop</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()drop</code> عبرها مع تمرير عدد كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-    val str = "hsoub"
+val str = "wiki Hsoub"
-    println(str.count()) // => 5
+println(str.drop(0)) // wiki Hsoub
-}
+println(str.drop(2)) // ki Hsoub
-</syntaxhighlight>
+println(str.drop(5)) // Hsoub
+println(str.drop(8)) // ub
-=== استخدام الدالة <code>()drop</code> مع سلسلة نصية مع تمرير دالة منطقية كوسيط ===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()drop</code> عبرها مع تمرير  دالة منطقية كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val str = "Hsoub Wiki"
-    println(str.count {it.isUpperCase()}) // => 2
 }
 </syntaxhighlight>
@@ سطر 40: / سطر 30: @@
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/count.html الدالة text.drop()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/drop.html الدالة text.drop()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]