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

من موسوعة حسوب
→ التعديل السابقالتعديل اللاحق ←
مرئينص الويكي
لا ملخص تعديل
ط مراجعة وتدقيق.
سطر 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>minWith()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد المدخل (Entry) الأول في  ذلك [[Kotlin/Map|القاموس]] والذي له أصغر قيمة حسب المقارِن <code>comparator</code>، أو <code>null</code> إن لم يكن هناك أي مدخل يحقق ذلك.
 
==البنية العامة==
==البنية العامة==
يمكن استدعاء الدالة <code>minWith()‎</code> عبر  '''[[Kotlin/Array|المصفوفات]] و [[Kotlin/collections|المجموعات]]:'''<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة <code>maxWith()‎</code> مع [[Kotlin/Array|المصفوفات]] و [[Kotlin/collections|المجموعات]] والخرائط:<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.minWith(
fun <T> Array<out T>.minWith(
     comparator: Comparator<in T>
     comparator: Comparator<in T>
): T?
): T? (source)
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte?
fun ByteArray.minWith(comparator: Comparator<in Byte>): Byte? (source)
fun ShortArray.minWith(
fun ShortArray.minWith(
     comparator: Comparator<in Short>
     comparator: Comparator<in Short>
): Short?  
): Short? (source)
fun IntArray.minWith(comparator: Comparator<in Int>): Int?  
fun IntArray.minWith(comparator: Comparator<in Int>): Int? (source)
fun LongArray.minWith(comparator: Comparator<in Long>): Long?
fun LongArray.minWith(comparator: Comparator<in Long>): Long? (source)
fun FloatArray.minWith(
fun FloatArray.minWith(
     comparator: Comparator<in Float>
     comparator: Comparator<in Float>
): Float?
): Float? (source)
fun DoubleArray.minWith(
fun DoubleArray.minWith(
     comparator: Comparator<in Double>
     comparator: Comparator<in Double>
): Double?  
): Double? (source)
fun BooleanArray.minWith(
fun BooleanArray.minWith(
     comparator: Comparator<in Boolean>
     comparator: Comparator<in Boolean>
): Boolean?
): Boolean? (source)
fun CharArray.minWith(comparator: Comparator<in Char>): Char?
fun CharArray.minWith(comparator: Comparator<in Char>): Char? (source)
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T?
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T? (source)
</syntaxhighlight>'''بيئة التشغيل: JVM'''<syntaxhighlight lang="kotlin">
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?
</syntaxhighlight>'''بيئة التشغيل: JS'''


يمكن استدعاء الدالة <code>minWith()‎</code> عبر [[Kotlin/Map|القواميس]]:<syntaxhighlight lang="kotlin">
fun <K, V> Map<out K, V>.minWith(
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>? (source)
</syntaxhighlight>'''بيئة التشغيل: JVM'''<syntaxhighlight lang="kotlin">
</syntaxhighlight>
fun <K, V> Map<out K, V>.minWith(
==القيم المعادة==
    comparator: Comparator<in Entry<K, V>>
يُعاد العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة والذي له أصغر قيمة بحسب الدالة <code>comparator</code> الموازنة المعطاة، أو القيمة <code>null</code> إن لم يكن هنالك أي عنصر.
): Entry<K, V>?
</syntaxhighlight>'''بيئة التشغيل: JS'''
 
==القيم المٌعادة==
العنصر الأول في  [[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> مع المصفوفات===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفةً]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستدعي الدالة <code>()maxWith</code> مع تلك المصفوفة مع تمرير الدالة <code>comparator</code> الموازنة:<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, 4, 8, 16, 32)


     println(array.minWith(Comparator { a, b -> b - a })) // 6
     println(array.minWith(Comparator { a, b -> b - a })) // 32
}
}
</syntaxhighlight>
</syntaxhighlight>
===انظر أيضًا===
==انظر أيضًا==
*<code>[[Kotlin/collections/min|min()]]</code>‎: تعيد أصغر عنصر في  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
*الدالة <code>[[Kotlin/collections/maxWith|maxWith()‎]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن <code>comparator</code> المعطى.
 
*الدالة <code>[[Kotlin/collections/min|min()]]</code>‎: تجلب أصغر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
* <code>[[Kotlin/collections/max|max()]]</code>‎: تعيد أكبر عنصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
*الدالة <code>[[Kotlin/collections/minBy|minBy()‎]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.
 
==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/min-with.html الدالة  minWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/min-with.html صفحة الدالة minWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

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

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

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

يمكن استدعاء الدالة maxWith()‎ مع المصفوفات و المجموعات والخرائط:

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

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

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

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

أمثلة

تعرف الشيفرة الآتية مصفوفةً باسم array باستخدام الدالة ()arrayOf ثم تستدعي الدالة ()maxWith مع تلك المصفوفة مع تمرير الدالة comparator الموازنة:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 4, 8, 16, 32)

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

انظر أيضًا

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

مصادر

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