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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function')
ط
سطر 1: سطر 1:
ترشِّح الدالة <code>filterIndexed()‎</code> عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة التي أعيدت القيمة <code>true</code> معها عند تطبيق الدالة <code>predicate()‎</code> المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()‎</code> ثم تعيد بدورها قيمة منطقيَّة.
+
ترشِّح الدالة <code>filterIndexed()‎</code> عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة بناءً على فهرس العنصر وقيمته.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
سطر 33: سطر 33:
 
): List<T>
 
): List<T>
 
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (لمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
 
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (لمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
 +
 +
== المعاملات ==
 +
 +
=== <code>predicate</code> ===
 +
دالةٌ تمثل الشرط المراد تطبيقه على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة. يمرر إلى هذه الدالة فهرس العنصر وقيمته أيضًا وتعيد قيمة منطقية.
 +
 
==القيم المعادة==
 
==القيم المعادة==
تُعاد [[Kotlin/collections/List|قائمة]] تحوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة التي أعيدت القيمة <code>true</code> معها عند تطبيق الدالة <code>predicate()‎</code> المُمرّر عليها. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()‎</code> ثم تعيد بدورها قيمة منطقيَّة.
+
تُعاد [[Kotlin/collections/List|قائمة]] تحوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة التي أعيدت القيمة <code>true</code> معها عند تطبيق الدالة <code>predicate</code> عليها.
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>()filterIndexed</code> مع المصفوفات===
 
===استخدام الدالة <code>()filterIndexed</code> مع المصفوفات===

مراجعة 05:48، 3 سبتمبر 2018

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

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

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

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

المعاملات

predicate

دالةٌ تمثل الشرط المراد تطبيقه على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة. يمرر إلى هذه الدالة فهرس العنصر وقيمته أيضًا وتعيد قيمة منطقية.

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

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

أمثلة

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

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

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 1, 7, 3, 11)
    val predicate: (Int, Int) -> Boolean = { x, y -> x < y }

    println(array.filterIndexed(predicate)) // [1, 2, 7, 11]
}

انظر أيضًا

  • الدالة filterIndexedTo()‎: تضيف إلى المجموعة المتغيرة destination المُمرَّر إليها عناصر المصفوفة أو المجموعة المعطاة التي أعيدت القيمة true مع كل عنصر منها عند تطبيق الدالة predicate()‎ المُمرّر عليها. يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate()‎ ثم تعيد بدورها قيمة منطقيَّة.
  • الدالة filter(): ترشِّح عناصر المصفوفة أو المجموعة أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.
  • الدالة mapIndexed()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.
  • الدالة drop()‎: تعيد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء آخر n عنصر.
  • الدالة elementAt()‎: تجلب عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها.
  • الدالة fill()‎: تبدِّل قيمة جديدة معطاة مكان عناصر محدَّدة في المصفوفة أو القائمة التي تستدعى معها.
  • الدالة mapIndexed()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.

مصادر