الفرق بين المراجعتين لصفحة: «Kotlin/collections/dropWhile»
< Kotlin | collections
أنشأ الصفحة ب'<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>dropWhile()</code> [[Kotlin/List|لائحة]] تحتوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
inline fun <T> Array<out T>. | inline fun <T> Array<out T>.dropWhile( | ||
predicate: (T) -> Boolean | predicate: (T) -> Boolean | ||
): List<T> | ): List<T> | ||
inline fun ByteArray. | inline fun ByteArray.dropWhile( | ||
predicate: (Byte) -> Boolean | predicate: (Byte) -> Boolean | ||
): List<Byte> | ): List<Byte> | ||
inline fun ShortArray. | inline fun ShortArray.dropWhile( | ||
predicate: (Short) -> Boolean | predicate: (Short) -> Boolean | ||
): List<Short> | ): List<Short> | ||
inline fun IntArray. | inline fun IntArray.dropWhile( | ||
predicate: (Int) -> Boolean | predicate: (Int) -> Boolean | ||
): List<Int> | ): List<Int> | ||
inline fun LongArray. | inline fun LongArray.dropWhile( | ||
predicate: (Long) -> Boolean | predicate: (Long) -> Boolean | ||
): List<Long> | ): List<Long> | ||
inline fun FloatArray. | inline fun FloatArray.dropWhile( | ||
predicate: (Float) -> Boolean | predicate: (Float) -> Boolean | ||
): List<Float> | ): List<Float> | ||
inline fun DoubleArray. | inline fun DoubleArray.dropWhile( | ||
predicate: (Double) -> Boolean | predicate: (Double) -> Boolean | ||
): List<Double> | ): List<Double> | ||
inline fun BooleanArray. | inline fun BooleanArray.dropWhile( | ||
predicate: (Boolean) -> Boolean | predicate: (Boolean) -> Boolean | ||
): List<Boolean> | ): List<Boolean> | ||
inline fun CharArray. | inline fun CharArray.dropWhile( | ||
predicate: (Char) -> Boolean | predicate: (Char) -> Boolean | ||
): List<Char> | ): List<Char> | ||
inline fun <T> | 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|المجموعة]] التي استُدعيت عبرها باستثناء العناصر | [[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> تحدد ما إذا كان العدد المُمرّر إليها | تعرف الشيفرة الآتية [[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 | val predicate: (Int) -> Boolean = { it < 3} | ||
println(array. | println(array.dropWhile(predicate)) // [3, 4, 5, 6] | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا == | ==انظر أيضًا == | ||
* <code>[[Kotlin/collections/dropWhile|dropWhile()]]</code>: | * <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 | *[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 تحدد ما إذا كان العدد المُمرّر إليها أصغر من 3، ثم تستخدم الدالة ()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.