الفرق بين المراجعتين ل"Kotlin/collections/dropWhile"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>dropWhile()</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>dropWhile()</code> Kotlin/List|لا...') |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| (7 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة <code>dropWhile()</code> في | + | <noinclude>{{DISPLAYTITLE: الدالة <code>dropWhile()</code> في Kotlin}}</noinclude> |
| − | تعيد الدالة<code>dropWhile()</code> [[Kotlin/List| | + | تعيد الدالة <code>dropWhile()</code> [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا. |
== البنية العامة == | == البنية العامة == | ||
<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|توثيق الدوال المباشرة]]). |
| + | |||
| + | == المعاملات == | ||
| + | |||
| + | === <code>predicate</code> === | ||
| + | دالةٌ تمثل الشرط الذي سيُطبق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة. | ||
== القيم المعادة == | == القيم المعادة == | ||
| − | [[Kotlin/List| | + | تُعاد [[Kotlin/List|قائمة]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة باستثناء العناصر الأولى التي تعيد القيمة <code>true</code> عند تطبيق الدالة <code>predicate</code> المُمرّرة عليها. |
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()dropWhile</code> مع المصفوفات === | ===استخدام الدالة <code>()dropWhile</code> مع المصفوفات === | ||
| − | + | تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تعرف الدالة <code>predicate</code> المنطقية لاستعمالها مع الدالة <code>()dropWhile</code> لحذف العناصر الأولى التي تقل قيمتها عن القيمة 3:<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/ | + | *الدالة <code>[[Kotlin/collections/drop|drop()]]</code>: تعيد [[Kotlin/List|قائمة]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر. |
| − | * <code>[[Kotlin/collections/dropLast|dropLast()]]</code>: | + | *الدالة <code>[[Kotlin/collections/dropLast|dropLast()]]</code>: تعيد [[Kotlin/List|قائمة]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر. |
| − | * <code>[[Kotlin/collections/ | + | *الدالة <code>[[Kotlin/collections/dropLastWhile|dropLastWhile()]]</code>: تعيد [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا. |
| − | + | * الدالة <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 | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/drop-while.html صفحة الدالة dropWhile() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Collection]] | ||
المراجعة الحالية بتاريخ 07:46، 8 سبتمبر 2018
تعيد الدالة dropWhile() قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
البنية العامة
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 يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة).
المعاملات
predicate
دالةٌ تمثل الشرط الذي سيُطبق على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة.
القيم المعادة
تُعاد قائمة تحوي جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء العناصر الأولى التي تعيد القيمة 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(): تنسخ الدالة كامل المصفوفة التي استُدعيت معها أو جزءًا منها.