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

مراجعة 15:54، 8 أغسطس 2018

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

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

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

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

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

تعاد قائمة تحوي العناصر الأولى المحققة للشرط predicate المعطى من المصفوفة أو القائمة المعطاة.

أمثلة

استعمال الدالة ()takeWhile لجلب العناصر الأولى الأصغر من الحرف 'f' من قائمة:

fun main(args: Array<String>) {
    val chars = ('a'..'z').toList()
    println(chars.takeWhile { it < 'f' }) // [a, b, c, d, e]
}

انظر أيضًا

الدالة take()‎: تجلب أول n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.
الدالة takeLast()‎: تجلب آخر n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.
الدالة takeLastWhile()‎: تجلب آخر عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>takeWhile()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>takeWhile()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>takeWhile()‎</code> [[Kotlin/List|لائحة]] تضم أولى  عناصر [[Kotlin/Array|المصفوفة]] أو  [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+تجلب الدالة <code>takeWhile()‎</code> أول عناصر محققة لشرطٍ محدَّدٍ من [[Kotlin/Array|المصفوفة]] أو  [[Kotlin/List|القائمة]] التي استُدعيت معها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 34: / سطر 34: @@
 ): List<T>
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> التي تدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-==القيمة المُعادة==
+==القيمة المعادة==
-[[Kotlin/List|لائحة]] تضم أولى  عناصر [[Kotlin/Array|المصفوفة]] أو  [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+تعاد [[Kotlin/List|قائمة]] تحوي العناصر الأولى المحققة للشرط <code>predicate</code> المعطى من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/List|القائمة]] المعطاة.
 ==أمثلة==
-===استخدام الدالة <code>()takeWhile</code> مع المصفوفات===
+استعمال الدالة <code>()takeWhile</code> لجلب العناصر الأولى الأصغر من الحرف 'f' من قائمة:<syntaxhighlight lang="kotlin">
-تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()takeWhile</code>  على <code>array</code> مع تمرير دالة منطقية كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(3, 5, 7, 2 , 6, 9)
+    val chars = ('a'..'z').toList()
+     println(chars.takeWhile { it < 'f' }) // [a, b, c, d, e]
-println(array.takeWhile { it > 2 } ) // [3, 5, 7]
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-*<code>[[Kotlin/collections/take|take()]]</code>‎ : تعيد [[Kotlin/List|لائحة]] تضم  <code>n</code> من أولى العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.
+*الدالة <code>[[Kotlin/collections/take|take()]]</code>‎: تجلب أول <code>n</code> عنصر من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وتضعها في قائمة.
-* <code>[[Kotlin/collections/takeLast|takeLast()]]</code>‎ :تعيد [[Kotlin/List|لائحة]] تضم آخر <code>n</code> من العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.
+*الدالة <code>[[Kotlin/collections/takeLast|takeLast()]]</code>‎: تجلب آخر <code>n</code> عنصر من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وتضعها في قائمة.
-* <code>[[Kotlin/collections/takeLastWhile|takeLastWhile()]]</code>‎ : تعيد [[Kotlin/List|لائحة]] تضم آخر عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+*الدالة <code>[[Kotlin/collections/takeLastWhile|takeLastWhile()]]</code>‎: تجلب آخر عناصر محققة لشرطٍ محدَّدٍ من [[Kotlin/Array|المصفوفة]] أو  [[Kotlin/List|القائمة]] التي استُدعيت معها.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/take-while.html الدالة  takeWhile()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>takeWhile()‎</code> في لغة Kotlin}}</noinclude>
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/take-while.html صفحة الدالة takeWhile()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]