الفرق بين المراجعتين ل"Kotlin/collections/maxWith"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
|||
| (4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة <code>maxWith()</code> في | + | <noinclude>{{DISPLAYTITLE: الدالة <code>maxWith()</code> في Kotlin}}</noinclude> |
| − | + | تجلب الدالة <code>maxWith()</code> العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن <code>comparator</code> المعطى. | |
| − | |||
| − | |||
| − | |||
==البنية العامة== | ==البنية العامة== | ||
| − | يمكن استدعاء الدالة <code>maxWith()</code> | + | يمكن استدعاء الدالة <code>maxWith()</code> مع [[Kotlin/Array|المصفوفات]] و [[Kotlin/collections|المجموعات]] والخرائط:<syntaxhighlight lang="kotlin"> |
fun <T> Array<out T>.maxWith( | fun <T> Array<out T>.maxWith( | ||
comparator: Comparator<in T> | comparator: Comparator<in T> | ||
| − | ): T? | + | ): T? |
| − | fun ByteArray.maxWith(comparator: Comparator<in Byte>): Byte? | + | fun ByteArray.maxWith(comparator: Comparator<in Byte>): Byte? (source) |
fun ShortArray.maxWith( | fun ShortArray.maxWith( | ||
comparator: Comparator<in Short> | comparator: Comparator<in Short> | ||
): Short? | ): Short? | ||
| − | fun IntArray.maxWith(comparator: Comparator<in Int>): Int? | + | fun IntArray.maxWith(comparator: Comparator<in Int>): Int? (source) |
| − | fun LongArray.maxWith(comparator: Comparator<in Long>): Long? | + | fun LongArray.maxWith(comparator: Comparator<in Long>): Long? (source) |
fun FloatArray.maxWith( | fun FloatArray.maxWith( | ||
comparator: Comparator<in Float> | comparator: Comparator<in Float> | ||
| − | ): Float? | + | ): Float? |
fun DoubleArray.maxWith( | fun DoubleArray.maxWith( | ||
comparator: Comparator<in Double> | comparator: Comparator<in Double> | ||
| − | ): Double? | + | ): Double? |
fun BooleanArray.maxWith( | fun BooleanArray.maxWith( | ||
comparator: Comparator<in Boolean> | comparator: Comparator<in Boolean> | ||
): Boolean? | ): Boolean? | ||
| − | fun CharArray.maxWith(comparator: Comparator<in Char>): Char? | + | fun CharArray.maxWith(comparator: Comparator<in Char>): Char? (source) |
| − | fun <T> Iterable<T>.maxWith(comparator: Comparator<in T>): T? | + | fun <T> Iterable<T>.maxWith(comparator: Comparator<in T>): T? (source) |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
inline fun <K, V> Map<out K, V>.maxWith( | inline fun <K, V> Map<out K, V>.maxWith( | ||
comparator: Comparator<in Entry<K, V>> | comparator: Comparator<in Entry<K, V>> | ||
): Entry<K, V>? | ): Entry<K, V>? | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). |
| − | inline | ||
| − | |||
| − | ) | ||
| − | |||
| − | + | == المعاملات == | |
| − | == | + | === <code>comparator</code> === |
| − | + | دالةٌ تمثل الموزان الذي سيُطبَّق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة. | |
| − | + | ==القيم المعادة== | |
| + | يُعاد العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة والذي له أكبر قيمة بحسب الدالة <code>comparator</code> الموازنة المعطاة، أو القيمة <code>null</code> إن لم يكن هنالك أي عنصر. | ||
==أمثلة== | ==أمثلة== | ||
| − | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفةً]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستدعي الدالة <code>()maxWith</code> مع تلك المصفوفة مع تمرير الدالة <code>comparator</code> الموازنة:<syntaxhighlight lang="kotlin"> | |
| − | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array| | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val array = arrayOf(1, 2, | + | val array = arrayOf(1, 2, 4, 8, 16, 32) |
println(array.maxWith(Comparator { a, b -> b - a })) // 1 | println(array.maxWith(Comparator { a, b -> b - a })) // 1 | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ==انظر أيضًا== | |
| − | *<code>[[Kotlin/collections/ | + | *الدالة <code>[[Kotlin/collections/minWith|minWith()]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى. |
| − | + | *الدالة <code>[[Kotlin/collections/max|max()]]</code>: تجلب أكبر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها. | |
| − | * <code>[[Kotlin/collections/max|max()]]</code>: | + | *الدالة <code>[[Kotlin/collections/maxBy|maxBy()]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه. |
| − | |||
==مصادر== | ==مصادر== | ||
| − | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/max-with.html الدالة | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/max-with.html صفحة الدالة maxWith() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Collection]] | ||
المراجعة الحالية بتاريخ 09:24، 8 سبتمبر 2018
تجلب الدالة maxWith() العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن comparator المعطى.
البنية العامة
يمكن استدعاء الدالة maxWith() مع المصفوفات و المجموعات والخرائط:
fun <T> Array<out T>.maxWith(
comparator: Comparator<in T>
): T?
fun ByteArray.maxWith(comparator: Comparator<in Byte>): Byte? (source)
fun ShortArray.maxWith(
comparator: Comparator<in Short>
): Short?
fun IntArray.maxWith(comparator: Comparator<in Int>): Int? (source)
fun LongArray.maxWith(comparator: Comparator<in Long>): Long? (source)
fun FloatArray.maxWith(
comparator: Comparator<in Float>
): Float?
fun DoubleArray.maxWith(
comparator: Comparator<in Double>
): Double?
fun BooleanArray.maxWith(
comparator: Comparator<in Boolean>
): Boolean?
fun CharArray.maxWith(comparator: Comparator<in Char>): Char? (source)
fun <T> Iterable<T>.maxWith(comparator: Comparator<in T>): T? (source)
inline fun <K, V> Map<out K, V>.maxWith(
comparator: Comparator<in Entry<K, V>>
): Entry<K, V>?
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
المعاملات
comparator
دالةٌ تمثل الموزان الذي سيُطبَّق على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة المعطاة.
القيم المعادة
يُعاد العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة المعطاة والذي له أكبر قيمة بحسب الدالة comparator الموازنة المعطاة، أو القيمة null إن لم يكن هنالك أي عنصر.
أمثلة
تعرف الشيفرة الآتية مصفوفةً باسم array باستخدام الدالة ()arrayOf ثم تستدعي الدالة ()maxWith مع تلك المصفوفة مع تمرير الدالة comparator الموازنة:
fun main(args: Array<String>) {
val array = arrayOf(1, 2, 4, 8, 16, 32)
println(array.maxWith(Comparator { a, b -> b - a })) // 1
}
انظر أيضًا
- الدالة
minWith(): تجلب العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازنcomparatorالمعطى. - الدالة
max(): تجلب أكبر عنصر في المصفوفة أو المجموعة التي استُدعيت معها. - الدالة
maxBy(): تجلب العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.