عرض مصدر Kotlin/kotlin.text/drop

<noinclude>{{DISPLAYTITLE: الدالة <code>drop()‎</code> في Kotlin}}</noinclude>
تُزيِل الدالة <code>drop()‎</code> أول <code>n</code> محرف من محارف <nowiki/>[[Kotlin/String|السلسلة النصية]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.  
==البنية العامة==
<syntaxhighlight lang="kotlin">
fun CharSequence.drop(n: Int): CharSequence 

fun String.drop(n: Int): String

</syntaxhighlight>

== المعاملات ==

=== <code>n</code> ===
عدد صحيح يمثل عدد المحارف المراد حذفها من بداية السلسلة النصية.

==القيم المعادة==
تعاد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة من المحارف]] تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء أول <code>n</code> محرف. 
==أمثلة==
مثالٌ عن استعمال الدالة <code>()drop</code><nowiki/>:<syntaxhighlight lang="kotlin">
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
}
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <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>: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
* الدالة <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تجلب محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. 

==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/drop.html صفحة الدالة Text.drop()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]