الفرق بين المراجعتين لصفحة: «Kotlin/collections/flatten»
< Kotlin | collections
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>first()</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>flatten()</code> العنصر الأول...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code> | <noinclude>{{DISPLAYTITLE: الدالة <code>flatten()</code> في لغة Kotlin}}</noinclude> | ||
تعيد الدالة<code>flatten()</code> | تعيد الدالة<code>flatten()</code> [[Kotlin/collections/List|لائحة]] تحتوي جميع عناصر [[Kotlin/Array|المصفوفات]] أو [[Kotlin/collections|المجموعات]] التي تنتمي إلى [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
==البنية العامة== | ==البنية العامة== | ||
يمكن استدعاء الدالة<code>flatten()</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin"> | |||
fun <T> Array<out T>. | fun <T> Array<out Array<out T>>.flatten(): List<T> | ||
</syntaxhighlight> | </syntaxhighlight>يمكن استدعاء الدالة<code>flatten()</code> على [[Kotlin/Array|المجموعات]].<syntaxhighlight lang="kotlin"> | ||
fun <T> Iterable<Iterable<T>>.flatten(): List<T> | |||
): | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
[[Kotlin/collections/List|لائحة]] تحتوي جميع عناصر [[Kotlin/Array|المصفوفات]] أو [[Kotlin/collections|المجموعات]] التي تنتمي إلى [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | |||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>() | ===استخدام الدالة <code>()flatten</code> مع المصفوفات=== | ||
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code> | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>deepArray</code>مكونة من ثلاثة مصفوفات باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()flatten</code> لإنشاء [[Kotlin/collections/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفات]] المُنتمية إلى <code>deepArray</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val | val deepArray = arrayOf( | ||
arrayOf(1), | |||
arrayOf(2, 3), | |||
arrayOf(4, 5, 6) | |||
) | |||
println( | println(deepArray.flatten()) // [1, 2, 3, 4, 5, 6] | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===استخدام الدالة <code>()flatten</code> مع | ===استخدام الدالة <code>()flatten</code> مع اللوائح=== | ||
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array| | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|لائحة]]<nowiki/> باسم <code>deepList</code>مكونة من ثلاثة [[Kotlin/Array|لوائح]] باستخدام الدالة <code>()listOf</code>، ثم تستخدم الدالة <code>()flatten</code> لإنشاء [[Kotlin/collections/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|اللوائح]] المُنتميةإلى <code>deepList</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val | val deepList = listOf(listOf(1), listOf(2, 3), listOf(4, 5, 6)) | ||
println(deepList.flatten()) // [1, 2, 3, 4, 5, 6] | |||
println( | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 72: | سطر 35: | ||
*<code>[[Kotlin/collections/findLast|findLast()]]</code>: تعيد العنصر الأخير من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code> | *<code>[[Kotlin/collections/findLast|findLast()]]</code>: تعيد العنصر الأخير من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code> | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/ | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/flatten.html الدالة flatten() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 15:06، 16 مايو 2018
تعيد الدالةflatten() لائحة تحتوي جميع عناصر المصفوفات أو المجموعات التي تنتمي إلى المصفوفة أو المجموعة التي استُدعيت عبرها.
البنية العامة
يمكن استدعاء الدالةflatten() على المصفوفات.
fun <T> Array<out Array<out T>>.flatten(): List<T>
يمكن استدعاء الدالةflatten() على المجموعات.
fun <T> Iterable<Iterable<T>>.flatten(): List<T>
القيم المٌعادة
لائحة تحتوي جميع عناصر المصفوفات أو المجموعات التي تنتمي إلى المصفوفة أو المجموعة التي استُدعيت عبرها.
أمثلة
استخدام الدالة ()flatten مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم deepArrayمكونة من ثلاثة مصفوفات باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()flatten لإنشاء لائحة تضم جميع عناصر المصفوفات المُنتمية إلى deepArray، ثم تطبع الناتج:
fun main(args: Array<String>) {
val deepArray = arrayOf(
arrayOf(1),
arrayOf(2, 3),
arrayOf(4, 5, 6)
)
println(deepArray.flatten()) // [1, 2, 3, 4, 5, 6]
}
استخدام الدالة ()flatten مع اللوائح
تعرف الشيفرة الآتية لائحة باسم deepListمكونة من ثلاثة لوائح باستخدام الدالة ()listOf، ثم تستخدم الدالة ()flatten لإنشاء لائحة تضم جميع عناصر اللوائح المُنتميةإلى deepList، ثم تطبع الناتج:
fun main(args: Array<String>) {
val deepList = listOf(listOf(1), listOf(2, 3), listOf(4, 5, 6))
println(deepList.flatten()) // [1, 2, 3, 4, 5, 6]
}
انظر أيضًا
find(): تعيد العنصر الأول من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقيpredicateالمُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيدnull.findLast(): تعيد العنصر الأخير من المصفوفة أو المجموعة التي استُدعيت عبرها والذي يحقق الشرط المنطقيpredicateالمُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيدnull.