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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>reversed()‎</code> في لغة Kotlin}}</noinclude> تُراكِم الدالة<code>reversed()‎</code> القيم بد...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>reversed()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>reversed()‎</code> في لغة Kotlin}}</noinclude>
تُراكِم الدالة<code>reversed()‎</code> القيم بدءًا من العنصر الأول في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.  
تُعيد الدالة<code>reversed()‎</code>  [[Kotlin/List|لائحة]] تضم عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها بالترتيب المعكوس.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun <S, T : S> Array<out T>.reduceIndexed(
fun <T> Array<out T>.reversed(): List<T>  
    operation: (index: Int, acc: S, T) -> S
fun ByteArray.reversed(): List<Byte>  
): S
fun ShortArray.reversed(): List<Short>  
inline fun ByteArray.reduceIndexed(
fun IntArray.reversed(): List<Int>  
    operation: (index: Int, acc: Byte, Byte) -> Byte
fun LongArray.reversed(): List<Long>  
): Byte
fun FloatArray.reversed(): List<Float>  
inline fun ShortArray.reduceIndexed(
fun DoubleArray.reversed(): List<Double>  
    operation: (index: Int, acc: Short, Short) -> Short
fun BooleanArray.reversed(): List<Boolean>  
): Short
fun CharArray.reversed(): List<Char>  
inline fun IntArray.reduceIndexed(
fun <T> Iterable<T>.reversed(): List<T>
    operation: (index: Int, acc: Int, Int) -> Int
</syntaxhighlight>
): Int
inline fun LongArray.reduceIndexed(
    operation: (index: Int, acc: Long, Long) -> Long
): Long
inline fun FloatArray.reduceIndexed(
    operation: (index: Int, acc: Float, Float) -> Float
): Float
inline fun DoubleArray.reduceIndexed(
    operation: (index: Int, acc: Double, Double) -> Double
): Double
inline fun BooleanArray.reduceIndexed(
    operation: (index: Int, acc: Boolean, Boolean) -> Boolean
): Boolean
inline fun CharArray.reduceIndexed(
    operation: (index: Int, acc: Char, Char) -> Char
): Char  
 
</syntaxhighlight>تُراكِم الدالة<code>reduceIndexed()‎</code> القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.<syntaxhighlight lang="kotlin">
inline fun <S, T : S> Iterable<T>.reduceIndexed(
    operation: (index: Int, acc: S, T) -> S
): S
</syntaxhighlight>تُراكِم الدالة<code>reduceIndexed()‎</code> القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
 
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
==القيم المٌعادة==
==القيم المٌعادة==
قيمة التطبيق التراكُمي من اليسار إلى اليمين للعملية <code>operation</code> على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.  
[[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها بالترتيب المعكوس.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()reversed</code> مع المصفوفات===
===استخدام الدالة <code>()reversed</code> مع المصفوفات===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()reversed</code> على <code>array</code> بتمرير  دال، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية  لائحة باسم <code>list</code> مكونة من ستة أعداد باستخدام الدالة <code>()List<Int?>‎</code>، ثم تستخدم الدالة <code>()reversed</code> على <code>list</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
var list = listOf(1, 2, 3, 4, 5, 6)
 
   
val acc = array.reduceIndexed { acc , element , index -> acc + element*index }
print(list.reversed()) // [6, 5, 4, 3, 2, 1]
print(acc) // 1439
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
==انظر أيضًا==
* <code>[[Kotlin/collections/reduce|reduce()]]</code>‎: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي وفهرسه.
*<code>[[Kotlin/collections/reduce|reduce()]]</code>‎: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي وفهرسه.
 
==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/reduce-indexed.html الدالة  reversed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/reversed.html الدالة  reversed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 19:10، 3 يونيو 2018

تُعيد الدالةreversed()‎ لائحة تضم عناصر المصفوفة أو المجموعة التي استُدعيت عبرها بالترتيب المعكوس.

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

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

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

لائحة تضم عناصر المصفوفة أو المجموعة التي استُدعيت عبرها بالترتيب المعكوس.

أمثلة

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

تعرف الشيفرة الآتية  لائحة باسم list مكونة من ستة أعداد باستخدام الدالة ()List<Int?>‎، ثم تستخدم الدالة ()reversed على list، ثم تطبع الناتج:

fun main(args: Array<String>) {
var list = listOf(1, 2, 3, 4, 5, 6)
    
print(list.reversed()) // [6, 5, 4, 3, 2, 1]
}

انظر أيضًا

  • reduce()‎: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي وفهرسه.

مصادر