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