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

من موسوعة حسوب
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>minWith()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>minWith()‎</code> العنصر الأول...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>minWith()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>minWith()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة<code>minWith()‎</code> العنصر الأول في  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبره والذي له أكبر قيمة بحسب دالة المقارنة <code>comparator</code> الممرّرة، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.
تعيد الدالة<code>minWith()‎</code> العنصر الأول في  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن <code>comparator</code> الممرّر، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.


في حال استدعاء الدالة <code>minWith()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد المدخل (Entry) الأول في  ذلك [[Kotlin/Map|القاموس]] والذي له أكبر قيمة حسب دالة المقارنة <code>comparator</code>، أو <code>null</code> إن لم يكن هناك أي مدخل يحقق ذلك.
في حال استدعاء الدالة <code>minWith()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد المدخل (Entry) الأول في  ذلك [[Kotlin/Map|القاموس]] والذي له أصغر قيمة حسب المقارِن <code>comparator</code>، أو <code>null</code> إن لم يكن هناك أي مدخل يحقق ذلك.


==البنية العامة==
==البنية العامة==
يمكن استدعاء الدالة <code>minWith()‎</code> عبر  '''[[Kotlin/Array|المصفوفات]] و [[Kotlin/collections|المجموعات]]:'''<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة <code>minWith()‎</code> عبر  '''[[Kotlin/Array|المصفوفات]] و [[Kotlin/collections|المجموعات]]:'''<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.maxWith(
fun <T> Array<out T>.minWith(
     comparator: Comparator<in T>
     comparator: Comparator<in T>
): T?  
): T?
fun ByteArray.maxWith(comparator: Comparator<in Byte>): Byte?  
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte?
fun ShortArray.maxWith(
fun ShortArray.minWith(
     comparator: Comparator<in Short>
     comparator: Comparator<in Short>
): Short?
): Short?  
fun IntArray.maxWith(comparator: Comparator<in Int>): Int?
fun IntArray.minWith(comparator: Comparator<in Int>): Int?  
fun LongArray.maxWith(comparator: Comparator<in Long>): Long?  
fun LongArray.minWith(comparator: Comparator<in Long>): Long?
fun FloatArray.maxWith(
fun FloatArray.minWith(
     comparator: Comparator<in Float>
     comparator: Comparator<in Float>
): Float?
): Float?
fun DoubleArray.maxWith(
fun DoubleArray.minWith(
     comparator: Comparator<in Double>
     comparator: Comparator<in Double>
): Double?
): Double?  
fun BooleanArray.maxWith(
fun BooleanArray.minWith(
     comparator: Comparator<in Boolean>
     comparator: Comparator<in Boolean>
): Boolean?  
): Boolean?
fun CharArray.maxWith(comparator: Comparator<in Char>): Char?  
fun CharArray.minWith(comparator: Comparator<in Char>): Char?
fun <T> Iterable<T>.maxWith(comparator: Comparator<in T>): T?  
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T?
 
 
</syntaxhighlight>'''بيئة التشغيل: JVM'''<syntaxhighlight lang="kotlin">
</syntaxhighlight>'''بيئة التشغيل: JVM'''<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.maxWith(
fun <T> Array<out T>.minWith(
     comparator: Comparator<in T>
     comparator: Comparator<in T>
): T?
): T?
fun ByteArray.maxWith(comparator: Comparator<in Byte>): Byte?  
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte?
fun ShortArray.maxWith(
fun ShortArray.minWith(
     comparator: Comparator<in Short>
     comparator: Comparator<in Short>
): Short?
): Short?
fun IntArray.maxWith(comparator: Comparator<in Int>): Int?  
fun IntArray.minWith(comparator: Comparator<in Int>): Int?
fun LongArray.maxWith(comparator: Comparator<in Long>): Long?  
fun LongArray.minWith(comparator: Comparator<in Long>): Long?  
fun FloatArray.maxWith(
fun FloatArray.minWith(
     comparator: Comparator<in Float>
     comparator: Comparator<in Float>
): Float?
): Float?
fun DoubleArray.maxWith(
fun DoubleArray.minWith(
     comparator: Comparator<in Double>
     comparator: Comparator<in Double>
): Double?
): Double?
fun BooleanArray.maxWith(
fun BooleanArray.minWith(
     comparator: Comparator<in Boolean>
     comparator: Comparator<in Boolean>
): Boolean?
): Boolean?
fun CharArray.maxWith(comparator: Comparator<in Char>): Char?  
fun CharArray.minWith(comparator: Comparator<in Char>): Char?
fun <T> Iterable<T>.maxWith(comparator: Comparator<in T>): T?  
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T?
 
</syntaxhighlight>'''بيئة التشغيل: JS'''
</syntaxhighlight>'''بيئة التشغيل: JS'''


يمكن استدعاء الدالة <code>minWith()‎</code> عبر [[Kotlin/Map|القواميس]]:<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة <code>minWith()‎</code> عبر [[Kotlin/Map|القواميس]]:<syntaxhighlight lang="kotlin">
inline fun <K, V> Map<out K, V>.maxWith(
fun <K, V> Map<out K, V>.minWith(
     comparator: Comparator<in Entry<K, V>>
     comparator: Comparator<in Entry<K, V>>
): Entry<K, V>?
): Entry<K, V>?  
</syntaxhighlight>'''بيئة التشغيل: JVM'''<syntaxhighlight lang="kotlin">
</syntaxhighlight>'''بيئة التشغيل: JVM'''<syntaxhighlight lang="kotlin">
inline fun <K, V> Map<out K, V>.maxWith(
fun <K, V> Map<out K, V>.minWith(
     comparator: Comparator<in Entry<K, V>>
     comparator: Comparator<in Entry<K, V>>
): Entry<K, V>?
): Entry<K, V>?
</syntaxhighlight>'''بيئة التشغيل: JS'''
</syntaxhighlight>'''بيئة التشغيل: JS'''
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].


==القيم المٌعادة==
==القيم المٌعادة==
العنصر الأول في  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبره والذي له أكبر قيمة بحسب دالة المقارنة <code>comparator</code> الممرّرة، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.
العنصر الأول في  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن <code>comparator</code> الممرّر، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.


في حال استدعاء الدالة <code>minWith()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد المدخل (Entry) الأول في  ذلك [[Kotlin/Map|القاموس]] والذي له أكبر قيمة حسب دالة المقارنة <code>comparator</code>، أو <code>null</code> إن لم يكن هناك أي مدخل يحقق ذلك.
في حال استدعاء الدالة <code>minWith()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد المدخل (Entry) الأول في  ذلك [[Kotlin/Map|القاموس]] والذي له أصغر قيمة حسب المقارِن <code>comparator</code>، أو <code>null</code> إن لم يكن هناك أي مدخل يحقق ذلك.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()minWith</code> مع المصفوفات===
===استخدام الدالة <code>()minWith</code> مع المصفوفات===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/> باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستدعي الدالة <code>()minWith</code> عبر <code>array</code> مع تمرير مقارِن <code>comparator</code><nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/> باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستدعي الدالة <code>()minWith</code> عبر <code>array</code> مع تمرير مقارِن <code>comparator</code><nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
     val array = arrayOf(1, 2, 3, 4, 5,6)
     val array = arrayOf(1, 2, 3, 4, 5, 6)


     println(array.maxWith(Comparator { a, b -> b - a })) // 1
     println(array.minWith(Comparator { a, b -> b - a })) // 6
}
}
</syntaxhighlight>
</syntaxhighlight>
سطر 83: سطر 78:


==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/max-with.html الدالة  minWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/min-with.html الدالة  minWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 14:13، 31 مايو 2018

تعيد الدالةminWith()‎ العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن comparator الممرّر، أو null إن لم يكن هناك أي عنصر يحقق ذلك.

في حال استدعاء الدالة minWith()‎ عبر قاموس فستعيد المدخل (Entry) الأول في ذلك القاموس والذي له أصغر قيمة حسب المقارِن comparator، أو null إن لم يكن هناك أي مدخل يحقق ذلك.

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

يمكن استدعاء الدالة minWith()‎ عبر المصفوفات و المجموعات:

fun <T> Array<out T>.minWith(
    comparator: Comparator<in T>
): T?
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte?
fun ShortArray.minWith(
    comparator: Comparator<in Short>
): Short? 
fun IntArray.minWith(comparator: Comparator<in Int>): Int? 
fun LongArray.minWith(comparator: Comparator<in Long>): Long?
fun FloatArray.minWith(
    comparator: Comparator<in Float>
): Float?
fun DoubleArray.minWith(
    comparator: Comparator<in Double>
): Double? 
fun BooleanArray.minWith(
    comparator: Comparator<in Boolean>
): Boolean?
fun CharArray.minWith(comparator: Comparator<in Char>): Char?
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T?

بيئة التشغيل: JVM

fun <T> Array<out T>.minWith(
    comparator: Comparator<in T>
): T?
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte?
fun ShortArray.minWith(
    comparator: Comparator<in Short>
): Short?
fun IntArray.minWith(comparator: Comparator<in Int>): Int?
fun LongArray.minWith(comparator: Comparator<in Long>): Long? 
fun FloatArray.minWith(
    comparator: Comparator<in Float>
): Float?
fun DoubleArray.minWith(
    comparator: Comparator<in Double>
): Double?
fun BooleanArray.minWith(
    comparator: Comparator<in Boolean>
): Boolean?
fun CharArray.minWith(comparator: Comparator<in Char>): Char?
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T?

بيئة التشغيل: JS يمكن استدعاء الدالة minWith()‎ عبر القواميس:

fun <K, V> Map<out K, V>.minWith(
    comparator: Comparator<in Entry<K, V>>
): Entry<K, V>?

بيئة التشغيل: JVM

fun <K, V> Map<out K, V>.minWith(
    comparator: Comparator<in Entry<K, V>>
): Entry<K, V>?

بيئة التشغيل: JS

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

العنصر الأول في المصفوفة أو المجموعة التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن comparator الممرّر، أو null إن لم يكن هناك أي عنصر يحقق ذلك.

في حال استدعاء الدالة minWith()‎ عبر قاموس فستعيد المدخل (Entry) الأول في ذلك القاموس والذي له أصغر قيمة حسب المقارِن comparator، أو null إن لم يكن هناك أي مدخل يحقق ذلك.

أمثلة

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

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستدعي الدالة ()minWith عبر array مع تمرير مقارِن comparator، ثم تطبع الناتج:

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

    println(array.minWith(Comparator { a, b -> b - a })) // 6
}

انظر أيضًا

مصادر

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