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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>reversed()‎</code> في لغة Kotlin}}</noinclude> تُراكِم الدالة<code>reversed()‎</code> القيم بد...'
 
طلا ملخص تعديل
 
(5 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 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(
تعاد [[Kotlin/List|قائمة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة بترتيب معكوس.
    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|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.  
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()reversed</code> مع المصفوفات===
استعمال الدالة <code>()reversed</code> لعكس ترتيب عناصر قائمة:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()reversed</code> على <code>array</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/reversedArray|reversedArray()]]</code>: تعيد [[Kotlin/Array|مصفوفةً]] تضم عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها بترتيب معكوس.
 
*الدالة <code>[[Kotlin/collections/reverse|reverse()]]</code>‎: تعكس ترتيب عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/List|القائمة]] التي استُدعيت معها.
==مصادر==
==مصادر==
*[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 Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 10:12، 8 سبتمبر 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 لعكس ترتيب عناصر قائمة:

fun main(args: Array<String>) {
    var list = listOf(1, 2, 3, 4, 5, 6)

    print(list.reversed()) // [6, 5, 4, 3, 2, 1]
}

انظر أيضًا

مصادر