الفرق بين المراجعتين لصفحة: «Kotlin/collections/asIterable»

مراجعة 13:22، 10 مايو 2018

تُنشئ الدالة asIterable()‎نسخة تكرارية (Iterable instance) والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تُستخدم في حلقات التكرار (مثل for).

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

في حال استدعاء الدالة asIterable()‎عبر مصفوفة فستعيد نسخة تكرارية (Iterable instance) والتي تُغلّف المصفوفة التي استُدعيت عبرها وتعيد عناصرها عندما تُستخدم في حلقات التكرار (مثل for):

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

يمكن استدعاء الدالة asIterable()‎عبر مجموعة (collection) وستُعيدها على شكل مُكرّر (iterable):

inline fun <T> Iterable<T>.asIterable(): Iterable<T>

يمكن استدعاء الدالة asIterable()‎عبر قاموس (Map) وستعيد نسخة تكرارية (Iterable instance) والتي تُغلّف القاموس الاصلي وتعيد مداخله (entries) عندما تُستخدم في حلقات التكرار (مثل for)::

inline fun <K, V> Map<out K, V>.asIterable(): Iterable<Entry<K, V>>

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

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

نسخة تكرارية (Iterable instance). (انظر شرح الدالة أعلاه لمزيد من التفاصيل)

أمثلة

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

تعرف الشيفرة الآتية مصفوفة باسم array مكونة من أربعة أعداد باستخدام الدالة ()arrayOf، ثم تنشئ مُكرّرا باسم iter باستخدام الدالة ()asIterableثم تستخدم ذلك المكرر في حلقة تكرارية for:

fun main(args: Array<String>) {
val array = arrayOf(6,7,8,9)  // انشاء مصفوفة
val iter = array.asIterable() // انشاء مكرر
 
for (i in iter) print(i) // 6789
}

انظر أيضًا

asList()‎: تعيد لائحة والتي تُغلّف المصفوفة الاصلية.
asSequence()‎: تعيد نسخة من النوع Sequence والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تطبق تستخدم في حلقات التكرار (مثل for).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>asIterable()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>asIterable()‎</code> في لغة Kotlin}}</noinclude>تُنشئ الدالة <code>asIterable()‎</code>نسخة تكرارية (Iterable instance) والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تُستخدم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
-تُنشئ الدالة <code>asIterable()‎</code>نسخة تكرارية (Iterable instance) والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تطبق عليها حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
+==البنية العامة==
-== البنية العامة ==
+في حال استدعاء الدالة <code>asIterable()‎</code>عبر مصفوفة فستعيد نسخة تكرارية (Iterable instance) والتي تُغلّف المصفوفة التي استُدعيت عبرها وتعيد عناصرها عندما تُستخدم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>):<syntaxhighlight lang="kotlin">
-يمكن استدعاء الدالة <code>asIterable()‎</code>عبر مصفوفة دون معامل:<syntaxhighlight lang="kotlin">
 fun <T> Array<out T>.asIterable(): Iterable<T>
 fun ByteArray.asIterable(): Iterable<Byte>
@@ سطر 12: / سطر 11: @@
 fun BooleanArray.asIterable(): Iterable<Boolean>
 fun CharArray.asIterable(): Iterable<Char>
-</syntaxhighlight>يمكن استدعاء الدالة <code>any()‎</code>عبر مصفوفة بتمرير دالة كمعامل:<syntaxhighlight lang="kotlin">
+</syntaxhighlight>يمكن استدعاء الدالة <code>asIterable()‎</code>عبر مجموعة (collection) وستُعيدها على شكل مُكرّر (iterable):<syntaxhighlight lang="kotlin">
-inline fun <T> Array<out T>.any(predicate: (T) -> Boolean): Boolean
+inline fun <T> Iterable<T>.asIterable(): Iterable<T>
-inline fun ByteArray.any(predicate: (Byte) -> Boolean): Boolean
-inline fun ShortArray.any(predicate: (Short) -> Boolean): Boolean
-inline fun IntArray.any(predicate: (Int) -> Boolean): Boolean
-inline fun LongArray.any(predicate: (Long) -> Boolean): Boolean
-inline fun FloatArray.any(predicate: (Float) -> Boolean): Boolean
-inline fun DoubleArray.any(predicate: (Double) -> Boolean): Boolean
-inline fun BooleanArray.any(predicate: (Boolean) -> Boolean): Boolean
-inline fun CharArray.any(predicate: (Char) -> Boolean): Boolean
-</syntaxhighlight>يمكن استدعاء الدالة <code>any()‎</code>عبر مُكرر (iterable) بتمرير دالة كمعامل:<syntaxhighlight lang="kotlin">
-inline fun <T> Iterable<T>.any(predicate: (T) -> Boolean): Boolean
-</syntaxhighlight>يمكن استدعاء الدالة <code>any()‎</code>عبر مُكرر (iterable) دون معامل:<syntaxhighlight lang="kotlin">
-fun <T> Iterable<T>.any(): Boolean
-</syntaxhighlight>يمكن استدعاء الدالة <code>any()‎</code>عبر قاموس (Map) بتمرير دالة كمعامل:<syntaxhighlight lang="kotlin">
+</syntaxhighlight>يمكن استدعاء الدالة <code>asIterable()‎</code>عبر قاموس (Map) وستعيد نسخة تكرارية (Iterable instance) والتي تُغلّف القاموس الاصلي وتعيد مداخله (entries) عندما تُستخدم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>)::<syntaxhighlight lang="kotlin">
-inline fun <K, V> Map<out K, V>.any(predicate: (Entry<K, V>) -> Boolean): Boolean
+inline fun <K, V> Map<out K, V>.asIterable(): Iterable<Entry<K, V>>
-</syntaxhighlight>يمكن استدعاء الدالة <code>any()‎</code>عبر قاموس (Map) دون معامل:<syntaxhighlight lang="kotlin">
-fun <K, V> Map<out K, V>.any(): Boolean
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+==القيم المعادة==
-== القيم المعادة ==
+نسخة تكرارية (Iterable instance). (انظر شرح الدالة أعلاه لمزيد من التفاصيل)
-<code>true</code> أو <code>false</code>. (انظر شرح الدالة أعلاه لمزيد من التفاصيل)
+==أمثلة==
+===استخدام الدالة <code>()asIterable</code> مع المصفوفات===
-== أمثلة ==
+تعرف الشيفرة الآتية مصفوفة باسم <code>array</code> مكونة من أربعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تنشئ مُكرّرا باسم <code>iter</code> باستخدام الدالة <code>()asIterable</code>ثم تستخدم ذلك المكرر في حلقة تكرارية <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>()asIterable</code> على اللوائح دون تمرير مُعامل ===
-تعرف الشيفرة الآتية لائحة (list) فارغة باسم <code>emptyList</code>  باستخدام الدالة <code>emptyList<Int>()</code>‎، ثم تعرف لائحة من 3 عناصر عددية باستخدام الدالة <code>listOf()‎</code>وتطبع قيمة استدعاء الدالة<code>()any</code> على كلا اللائحتين:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-val emptyList = emptyList<Int>()
-println(emptyList.any()) // false
-val nonEmptyList = listOf(1, 2, 3)
-println(nonEmptyList.any()) // true
-}
-</syntaxhighlight>
-=== ‎استخدام الدالة <code>()any</code> بتمرير دالة كمُعامل ===
-تعرف الشيفرة الآتيةدالة باسم <code>isEvent‎</code> لاختبار زوجية الأعداد، ثم تعرّف مجالًا (range) باسم  <code>zeroToTen</code> وتطبع قيمة ناتج استدعاء الدالة <code>()any</code> على ذلك المجال، ثم تعرف مجالًا باسم <code>odds</code> مكونًا من أعداد فردية باستخدام الدالة <code>map()‎</code> وتستدعي عبره  الدالة <code>()any</code> ثم تطبع الناتج، وفي الأخير تستدعي الدالة <code>()any</code> على لائحة فارغة وتطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val isEven: (Int) -> Boolean = { it % 2 == 0 }
+val array = arrayOf(6,7,8,9)  // انشاء مصفوفة
-val zeroToTen = 0..10
+val iter = array.asIterable() // انشاء مكرر
-println(zeroToTen.any(isEven)) // true
+for (i in iter) print(i) // 6789
-val odds = zeroToTen.map { it * 2 + 1 }
-println(odds.any { isEven(it) }) // false
-val emptyList = emptyList<Int>()
-println(emptyList.any { true }) // false
 }
 </syntaxhighlight>
+==انظر أيضًا==
-== انظر أيضًا ==
+*<code>[[Kotlin/collections/asList|asList()]]</code>‎: تعيد لائحة والتي تُغلّف المصفوفة الاصلية.
-* <code>[[Kotlin/collections/all|all()]]</code>‎: تُعيد القيمة <code>true</code> إن كانت كل عناصر المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المحددة، أو<code>false</code> خلاف ذلك.
+*<code>[[Kotlin/collections/asSequence|asSequence()]]</code>‎: تعيد نسخة من النوع Sequence  والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تطبق تستخدم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
+==مصادر==
-== مصادر ==
+<span> </span>
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/any.html الخاصيّة  any()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/as-iterable.html الدالة  asIterable()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]