الفرق بين المراجعتين لصفحة: «Kotlin/collections/dropWhile»

مراجعة 11:53، 4 يوليو 2018

تعيد الدالة dropLastWhile()‎ قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.

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

inline fun <T> Array<out T>.dropWhile(
    predicate: (T) -> Boolean
): List<T> 
inline fun ByteArray.dropWhile(
    predicate: (Byte) -> Boolean
): List<Byte> 
inline fun ShortArray.dropWhile(
    predicate: (Short) -> Boolean
): List<Short> 
inline fun IntArray.dropWhile(
    predicate: (Int) -> Boolean
): List<Int> 
inline fun LongArray.dropWhile(
    predicate: (Long) -> Boolean
): List<Long> 
inline fun FloatArray.dropWhile(
    predicate: (Float) -> Boolean
): List<Float> 
inline fun DoubleArray.dropWhile(
    predicate: (Double) -> Boolean
): List<Double> 
inline fun BooleanArray.dropWhile(
    predicate: (Boolean) -> Boolean
): List<Boolean> 
inline fun CharArray.dropWhile(
    predicate: (Char) -> Boolean
): List<Char> 
inline fun <T> Iterable<T>.dropWhile(
    predicate: (T) -> Boolean
): List<T>

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

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

تُعاد قائمة تحوي جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء العناصر الأولى التي تعيد القيمة true عند تطبيق الدالة predicate المُمرّرة عليها.

أمثلة

استخدام الدالة `()dropWhile` مع المصفوفات

تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تعرف الدالة predicate المنطقية لاستعمالها مع الدالة ()dropWhile لحذف العناصر الأولى التي تقل قيمتها عن القيمة 3:

fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
val predicate: (Int) -> Boolean = { it < 3}
println(array.dropWhile(predicate)) // [3, 4, 5, 6]
}

انظر أيضًا

الدالة drop()‎: تعيد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء آخر n عنصر.
الدالة dropLast()‎: تعيد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء أول n عنصر.
الدالة dropLastWhile()‎: تعيد قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
الدالة distinctBy()‎: تعيد قائمة تحتوي على العناصر الموجودة في المصفوفة أو المجموعة التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق دالة معينة عليها فقط.
الدالة copyOf()‎: تنسخ الدالة كامل المصفوفة التي استُدعيت معها أو جزءًا منها.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>dropWhile()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة<code>dropWhile()‎</code> [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة.
+تعيد الدالة <code>dropLastWhile()‎</code> [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
 == البنية العامة ==
@@ سطر 34: / سطر 34: @@
      predicate: (T) -> Boolean
 ): List<T>
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
 == القيم المعادة ==
-[[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة.
+تُعاد [[Kotlin/List|قائمة]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة باستثناء العناصر الأولى التي تعيد القيمة <code>true</code> عند تطبيق الدالة <code>predicate</code> المُمرّرة عليها.
 ==أمثلة==
 ===استخدام الدالة <code>()dropWhile</code> مع المصفوفات  ===
-تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تعرف دالة منطقية <code>predicate</code> تحدد ما إذا كان العدد المُمرّر إليها أصغر من <code>3،</code> ثم تستخدم الدالة <code>()dropWhile</code> للحصول على لائحة تضم جميع عناصر المصفوفة باستثناء العناصر الأولى التي تحقق الدالة المنطقية <code>()predicate</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تعرف الدالة <code>predicate</code> المنطقية لاستعمالها مع الدالة <code>()dropWhile</code> لحذف العناصر الأولى التي تقل قيمتها عن القيمة 3:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 val array = arrayOf(1,2,3,4,5,6)
@@ سطر 49: / سطر 49: @@
 </syntaxhighlight>
 ==انظر أيضًا  ==
-* <code>[[Kotlin/collections/dropWhile|dropWhile()]]</code>‎: تعيد لائحة تحتوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق شرطا منطقيا محددًا
+*الدالة <code>[[Kotlin/collections/drop|drop()]]</code>‎: تعيد [[Kotlin/List|قائمة]] تحوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر.
+*الدالة <code>[[Kotlin/collections/dropLast|dropLast()]]</code>‎: تعيد [[Kotlin/List|قائمة]] تحوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر.
-* <code>[[Kotlin/collections/dropLast|dropLast()]]</code>‎: تعيد لائحة تحتوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة المحددة بالمعامل المُمرّر <code>n</code>.
+*الدالة <code>[[Kotlin/collections/dropLastWhile|dropLastWhile()]]</code>‎: تعيد [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
-* <code>[[Kotlin/collections/drop|drop()]]</code>‎: تعيد [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى المحددة بالمعامل المُمرّر <code>n.</code>
+* الدالة <code>[[Kotlin/collections/distinctBy|distinctBy()‎]]</code>: تعيد قائمة تحتوي على العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق دالة معينة عليها فقط.
+* الدالة <code>[[Kotlin/collections/copyOf|copyOf()]]</code>‎: تنسخ الدالة كامل المصفوفة التي استُدعيت معها أو جزءًا منها.
 ==مصادر==
 *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/drop-while.html الدالة  dropWhile()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]