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