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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>max()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>max()‎</code> Kotlin/collections/List|لا...'
 
طلا ملخص تعديل
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>max()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>max()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>max()‎</code> [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>map()‎</code> على [[Kotlin/collections/Map|قاموس]] فستعيد [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries)  [[Kotlin/collections/Map|القاموس]].
تجلب الدالة <code>max()‎</code> أكبر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
==البنية العامة==
==البنية العامة==
يمكن استدعاء الدالة<code>max()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun <T, R> Array<out T>.map(
fun Array<out Double>.max(): Double?
    transform: (T) -> R
fun Array<out Float>.max(): Float?
): List<R>
fun FloatArray.max(): Float?
inline fun <R> ByteArray.map(transform: (Byte) -> R): List<R>
fun DoubleArray.max(): Double?
inline fun <R> ShortArray.map(
fun Iterable<Double>.max(): Double?
    transform: (Short) -> R
fun Iterable<Float>.max(): Float?
): List<R>
inline fun <R> IntArray.map(transform: (Int) -> R): List<R>
inline fun <R> LongArray.map(transform: (Long) -> R): List<R>
inline fun <R> FloatArray.map(
    transform: (Float) -> R
): List<R>
inline fun <R> DoubleArray.map(
    transform: (Double) -> R
): List<R>
inline fun <R> BooleanArray.map(
    transform: (Boolean) -> R
): List<R>
inline fun <R> CharArray.map(transform: (Char) -> R): List<R>


</syntaxhighlight>يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
fun <T : Comparable<T>> Array<out T>.max(): T?
inline fun <T, R> Iterable<T>.map(
fun ByteArray.max(): Byte?
    transform: (T) -> R
fun ShortArray.max(): Short?
): List<R>
fun IntArray.max(): Int?
</syntaxhighlight>يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/Map|القواميس]].<syntaxhighlight lang="kotlin">
fun LongArray.max(): Long?
inline fun <K, V, R> Map<out K, V>.map(
fun CharArray.max(): Char?
    transform: (Entry<K, V>) -> R
fun <T : Comparable<T>> Iterable<T>.max(): T?
): List<R>
</syntaxhighlight>'''الإصدار المطلوب:''' Kotlin 1.1.
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
==القيم المعادة==
==القيم المٌعادة==
يُعاد أكبر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة، أو القيمة <code>null</code> إن كانت تلك المصفوفة أو المجموعة فارغة، أو القيمة <code>NaN</code> إن كانت قيمة أيّ عنصر من العناصر تساوي <code>NaN</code>.
تعيد الدالة<code>max()‎</code> [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة المُمرّرة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>max()‎</code> على [[Kotlin/collections/Map|قاموس]] فستعيد [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries)  [[Kotlin/collections/Map|القاموس]].
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()max</code> مع القواميس===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستدعي الدالة <code>()max</code> لجلب أكبر عدد موجود في تلك المصفوفة:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Map|قاموسًا]] باسم <code>m</code>مكونًا من ثلاثة أزواج باستخدام الدالة <code>()mapOf</code>، ثم تُعرّف الدالة <code>()func</code>، ثم تستخدم الدالة <code>()max</code> بتمرير <code>()func</code> كمعامل<nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val m = mapOf("x" to 2, "y" to 6, "z" to 5)
    val array = arrayOf(0, 2, 3, 4, 7, 5)
val func : (Int) -> Array<Int> = { arrayOf(it)}


println(m.map { (a, b) -> listOf(a) }) // [[x], [y], [z]]
    println(array.max()) // 7
}
}
</syntaxhighlight>
</syntaxhighlight>
===انظر أيضًا===
==انظر أيضًا==
*<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تضيف إلى [[Kotlin/collections/List|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] وفهارسها.
*الدالة <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/map.html الدالة  max()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/max.html صفحة الدالة max()‎ في التوثيق الرسمي للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 09:24، 8 سبتمبر 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 المعطى.

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/collections/max&oldid=17145»