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

المراجعة الحالية بتاريخ 04:53، 3 سبتمبر 2018

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

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

fun CharSequence.drop(n: Int): CharSequence 

fun String.drop(n: Int): String

المعاملات

`n`

عدد صحيح يمثل عدد المحارف المراد حذفها من بداية السلسلة النصية.

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

تعاد سلسلة نصية أو سلسلة من المحارف تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء أول n محرف.

أمثلة

مثالٌ عن استعمال الدالة ()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
}

انظر أيضًا

الدالة dropLast()‎: تُزيِل آخر n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.
الدالة dropWhile()‎: تُزيِل المحارف الأولى المحققة لشرط معين من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.
الدالة compareTo()‎: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
الدالة elementAt()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.drop()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>drop()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>drop()‎</code> عدد حروف [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> فستعيد عدد الحروف التي تحقق تلك الدالة المنطقية.
+تُزيِل الدالة <code>drop()‎</code> أول <code>n</code> محرف من محارف <nowiki/>[[Kotlin/String|السلسلة النصية]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
 ==البنية العامة==
 <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>
+== المعاملات ==
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+=== <code>n</code> ===
+عدد صحيح يمثل عدد المحارف المراد حذفها من بداية السلسلة النصية.
 ==القيم المعادة==
-عدد من النوع <code>Int</code>.
+تعاد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة من المحارف]] تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء أول <code>n</code> محرف.
 ==أمثلة==
-===استخدام الدالة <code>()count</code> مع سلسلة نصية===
+مثالٌ عن استعمال الدالة <code>()drop</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()count</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val str = "hsoub"
-    println(str.count()) // => 5
-}
-</syntaxhighlight>
-=== استخدام الدالة <code>()drop</code> مع سلسلة نصية مع تمرير دالة منطقية كوسيط ===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()drop</code> عبرها مع تمرير  دالة منطقية كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val str = "Hsoub Wiki"
+     val str = "wiki Hsoub"
-     println(str.count {it.isUpperCase()}) // => 2
+     println(str.drop(0)) // wiki Hsoub
+    println(str.drop(2)) // ki Hsoub
+    println(str.drop(5)) // Hsoub
+    println(str.drop(8)) // ub
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/contains|contains()]]‎</code>: تعيد القيمة <code>true</code> إن كانت سلسلة الحروف التي استُدعيت عبرها تحتوي الحرف أو سلسلة الحروف المُمرّرة. الوسيط<code>ignoreCase</code> يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.
+* الدالة <code>[[Kotlin/kotlin.text/dropLast|dropLast()]]‎</code>: تُزيِل آخر <code>n</code> محرف من محارف <nowiki/>[[Kotlin/String|السلسلة النصية]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/kotlin.text/dropWhile|dropWhile()‎]]</code>: تُزيِل المحارف الأولى المحققة لشرط معين من محارف <nowiki/>[[Kotlin/String|السلسلة النصية]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
-* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
+* الدالة <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+* الدالة <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تجلب محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
 ==مصادر==
-*[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]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]