الفرق بين المراجعتين ل"Kotlin/collections/dropWhile"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>dropWhile()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>dropWhile()‎</code> Kotlin/List|لا...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>dropWhile()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>dropWhile()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة<code>dropWhile()‎</code> [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة.
+
تعيد الدالة<code>dropWhile()‎</code> [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة.
  
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.dropLastWhile(
+
inline fun <T> Array<out T>.dropWhile(
 
     predicate: (T) -> Boolean
 
     predicate: (T) -> Boolean
): List<T> (source)
+
): List<T>  
inline fun ByteArray.dropLastWhile(
+
inline fun ByteArray.dropWhile(
 
     predicate: (Byte) -> Boolean
 
     predicate: (Byte) -> Boolean
 
): List<Byte>  
 
): List<Byte>  
inline fun ShortArray.dropLastWhile(
+
inline fun ShortArray.dropWhile(
 
     predicate: (Short) -> Boolean
 
     predicate: (Short) -> Boolean
 
): List<Short>  
 
): List<Short>  
inline fun IntArray.dropLastWhile(
+
inline fun IntArray.dropWhile(
 
     predicate: (Int) -> Boolean
 
     predicate: (Int) -> Boolean
 
): List<Int>  
 
): List<Int>  
inline fun LongArray.dropLastWhile(
+
inline fun LongArray.dropWhile(
 
     predicate: (Long) -> Boolean
 
     predicate: (Long) -> Boolean
 
): List<Long>  
 
): List<Long>  
inline fun FloatArray.dropLastWhile(
+
inline fun FloatArray.dropWhile(
 
     predicate: (Float) -> Boolean
 
     predicate: (Float) -> Boolean
 
): List<Float>  
 
): List<Float>  
inline fun DoubleArray.dropLastWhile(
+
inline fun DoubleArray.dropWhile(
 
     predicate: (Double) -> Boolean
 
     predicate: (Double) -> Boolean
 
): List<Double>  
 
): List<Double>  
inline fun BooleanArray.dropLastWhile(
+
inline fun BooleanArray.dropWhile(
 
     predicate: (Boolean) -> Boolean
 
     predicate: (Boolean) -> Boolean
): List<Boolean>
+
): List<Boolean>  
inline fun CharArray.dropLastWhile(
+
inline fun CharArray.dropWhile(
 
     predicate: (Char) -> Boolean
 
     predicate: (Char) -> Boolean
 
): List<Char>  
 
): List<Char>  
inline fun <T> List<T>.dropLastWhile(
+
inline fun <T> Iterable<T>.dropWhile(
 
     predicate: (T) -> Boolean
 
     predicate: (T) -> Boolean
): List<T>
+
): List<T>  
</syntaxhighlight>
+
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
  
 
== القيم المعادة ==
 
== القيم المعادة ==
  
[[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة  التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة.
+
[[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة.
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>()dropWhile</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>3،</code> ثم تستخدم الدالة <code>()dropWhile</code> للحصول على لائحة تضم جميع عناصر المصفوفة باستثناء العناصر الأولى التي تحقق الدالة المنطقية <code>()predicate</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
val array = arrayOf(1,2,3,4,5,6)
 
val array = arrayOf(1,2,3,4,5,6)
val predicate: (Int) -> Boolean = { it > 3}
+
val predicate: (Int) -> Boolean = { it < 3}
println(array.dropLastWhile(predicate)) // [1, 2, 3]
+
println(array.dropWhile(predicate)) // [3, 4, 5, 6]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا  ==
 
==انظر أيضًا  ==
* <code>[[Kotlin/collections/dropWhile|dropWhile()]]</code>‎: تعيد [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق شرطا منطقيا محددًا.
+
* <code>[[Kotlin/collections/dropWhile|dropWhile()]]</code>‎: تعيد لائحة تحتوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق شرطا منطقيا محددًا
 +
 
 
* <code>[[Kotlin/collections/dropLast|dropLast()]]</code>‎: تعيد لائحة تحتوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة المحددة بالمعامل المُمرّر <code>n</code>.
 
* <code>[[Kotlin/collections/dropLast|dropLast()]]</code>‎: تعيد لائحة تحتوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة المحددة بالمعامل المُمرّر <code>n</code>.
 
* <code>[[Kotlin/collections/drop|drop()]]</code>‎: تعيد [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى المحددة بالمعامل المُمرّر <code>n.</code>
 
* <code>[[Kotlin/collections/drop|drop()]]</code>‎: تعيد [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى المحددة بالمعامل المُمرّر <code>n.</code>
  
 
==مصادر==
 
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/drop-last-while.html الدالة  dropWhile()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/drop-while.html الدالة  dropWhile()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 18:27، 13 مايو 2018

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

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

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 للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

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

أمثلة

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

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تعرف دالة منطقية predicate تحدد ما إذا كان العدد المُمرّر إليها أصغر من ثم تستخدم الدالة ()dropWhile للحصول على لائحة تضم جميع عناصر المصفوفة باستثناء العناصر الأولى التي تحقق الدالة المنطقية ()predicate ثم تطبع الناتج:

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]
}

انظر أيضًا

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

مصادر