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

من موسوعة حسوب
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function'
مراجعة وتدقيق.
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.dropLastWhile()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>dropLastWhile()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>dropLastWhile()‎</code> جزءًا من [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مع حذف الحروف الأخيرة التي تحقق الشرط المنطقي المُمرّر  <code>predicate</code>.   
تُزيِل الدالة <code>dropLastWhile()‎</code> المحارف الأخيرة المحققة لشرط معين من محارف <nowiki/>[[Kotlin/String|السلسلة النصية]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.   
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 10: سطر 10:
     predicate: (Char) -> Boolean
     predicate: (Char) -> Boolean
): String
): String
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 
== المعاملات ==
 
=== <code>predicate</code> ===
دالةٌ تمثل الشرط الذي سيُطبق على كل محرف من محارف السلسلة النصية أو سلسلة المحارف المعطاة.


==القيم المعادة==
==القيم المعادة==
[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]].  
تعاد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة من المحارف]] تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء المحارف الأخيرة المحققة للشرط المحدد في المعامل <code>predicate</code>. 
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()dropLastWhile</code> مع سلسلة نصية===
مثالٌ عن استعمال الدالة <code>()dropLastWhile</code><nowiki/>:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()dropLastWhile</code> عبرها مع تمرير دالة منطقية كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val str = "wiki Hsoub"  
    val str = "wiki Hsoub"
      
 
println(str.dropLastWhile { it > 'H' }) // wiki H
     println(str.dropLastWhile { it > 'H' }) // wiki H
}
}
</syntaxhighlight>
</syntaxhighlight>


== انظر أيضًا ==
== انظر أيضًا ==
* <code>[[Kotlin/kotlin.text/dropLast|dropLast()]]</code>: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف آخر <code>n</code> حرفًا.
* الدالة <code>[[Kotlin/kotlin.text/dropWhile|dropWhile()]]</code>: تُزيِل المحارف الأولى المحققة لشرط معين من محارف <nowiki/>[[Kotlin/String|السلسلة النصية]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.  


* <code>[[Kotlin/kotlin.text/drop|drop()]]‎</code>: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف أول <code>n</code> حرفًا. 
* الدالة <code>[[Kotlin/kotlin.text/drop|drop()]]‎</code>: تُزيِل أول <code>n</code> محرف من محارف <nowiki/>[[Kotlin/String|السلسلة النصية]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. 
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.


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

المراجعة الحالية بتاريخ 14:59، 2 سبتمبر 2018

تُزيِل الدالة dropLastWhile()‎ المحارف الأخيرة المحققة لشرط معين من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

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

inline fun CharSequence.dropLastWhile(
    predicate: (Char) -> Boolean
): CharSequence

inline fun String.dropLastWhile(
    predicate: (Char) -> Boolean
): String

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

predicate

دالةٌ تمثل الشرط الذي سيُطبق على كل محرف من محارف السلسلة النصية أو سلسلة المحارف المعطاة.

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

تعاد سلسلة نصية أو سلسلة من المحارف تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء المحارف الأخيرة المحققة للشرط المحدد في المعامل predicate

أمثلة

مثالٌ عن استعمال الدالة ()dropLastWhile:

fun main(args: Array<String>) {
    val str = "wiki Hsoub"

    println(str.dropLastWhile { it > 'H' }) // wiki H
}

انظر أيضًا

مصادر