الفرق بين المراجعتين ل"Kotlin/collections/max"

مراجعة 15:15، 25 يوليو 2018

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

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

fun Array<out Double>.max(): Double? 
fun Array<out Float>.max(): Float? 
fun FloatArray.max(): Float? 
fun DoubleArray.max(): Double?
fun Iterable<Double>.max(): Double?
fun Iterable<Float>.max(): Float?

fun <T : Comparable<T>> Array<out T>.max(): T? 
fun ByteArray.max(): Byte? 
fun ShortArray.max(): Short? 
fun IntArray.max(): Int? 
fun LongArray.max(): Long? 
fun CharArray.max(): Char? 
fun <T : Comparable<T>> Iterable<T>.max(): T?

الإصدار المطلوب: Kotlin 1.1.

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

يُعاد أكبر عنصر في المصفوفة أو المجموعة المعطاة، أو القيمة null إن كانت تلك المصفوفة أو المجموعة فارغة، أو القيمة NaN إن كانت قيمة أيّ عنصر من العناصر تساوي NaN.

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستدعي الدالة ()max لجلب أكبر عدد موجود في تلك المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(0, 2, 3, 4, 7, 5)

    println(array.max()) // 7
}

انظر أيضًا

الدالة min()‎: تجلب أصغر عنصر في المصفوفة أو المجموعة التي استُدعيت معها.
الدالة maxBy()‎: تجلب العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
الدالة maxWith()‎: تجلب العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن comparator المعطى.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>max()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>max()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>max()‎</code> أكبر عنصر في  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
+تجلب الدالة <code>max()‎</code> أكبر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 10: / سطر 9: @@
 fun Iterable<Double>.max(): Double?
 fun Iterable<Float>.max(): Float?
-</syntaxhighlight>'''بيئة التشغيل: Kotlin 1.1'''
-إن كان أيّ من العناصر  يساوي <code>NaN</code> فستعيد الدالة<code>max()‎</code> القيمة <code>NaN</code>: <syntaxhighlight lang="kotlin">
 fun <T : Comparable<T>> Array<out T>.max(): T?
 fun ByteArray.max(): Byte?
@@ سطر 20: / سطر 17: @@
 fun CharArray.max(): Char?
 fun <T : Comparable<T>> Iterable<T>.max(): T?
-</syntaxhighlight>
+</syntaxhighlight>'''الإصدار المطلوب:''' Kotlin 1.1.
-==القيم المٌعادة==
+==القيم المعادة==
-أكبر عنصر في  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
+يُعاد أكبر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة، أو القيمة <code>null</code> إن كانت تلك المصفوفة أو المجموعة فارغة، أو القيمة <code>NaN</code> إن كانت قيمة أيّ عنصر من العناصر تساوي <code>NaN</code>.
 ==أمثلة==
-===استخدام الدالة <code>()max</code> مع المصفوفات===
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستدعي الدالة <code>()max</code> لجلب أكبر عدد موجود في تلك المصفوفة:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/> باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستدعي الدالة <code>()max</code> عبر <code>array</code>   للحصول على أكبر عدد فيها<nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(0, 2, 2, 4, 7, 5)
+    val array = arrayOf(0, 2, 3, 4, 7, 5)
-println(array.max())   // 7
+    println(array.max()) // 7
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
-*<code>[[Kotlin/collections/min|min()]]</code>‎: تعيد أصغر عنصر في  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
+*الدالة <code>[[Kotlin/collections/min|min()]]</code>‎: تجلب أصغر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
+*الدالة <code>[[Kotlin/collections/maxBy|maxBy()‎]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
+*الدالة <code>[[Kotlin/collections/maxWith|maxWith()‎]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن <code>comparator</code> المعطى.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/max.html الدالة  max()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/max.html صفحة الدالة max()‎ في التوثيق الرسمي للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]