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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>min()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>min()‎</code> أكبر عنصر في Kotli...')
 
ط
 
(3 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>min()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>min()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>min()‎</code> أكبر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
+
تجلب الدالة <code>min()‎</code> أصغر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
 
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
fun Array<out Double>.max(): Double?  
+
fun Array<out Double>.min(): Double?  
fun Array<out Float>.max(): Float?  
+
fun Array<out Float>.min(): Float?
fun FloatArray.max(): Float?  
+
fun FloatArray.min(): Float?  
fun DoubleArray.max(): Double?
+
fun DoubleArray.min(): Double?  
fun Iterable<Double>.max(): Double?
+
fun Iterable<Double>.min(): Double?
fun Iterable<Float>.max(): Float?
+
fun Iterable<Float>.min(): Float?
</syntaxhighlight>'''بيئة التشغيل: Kotlin 1.1'''
 
  
إن كان أيّ من العناصر  يساوي <code>NaN</code> فستعيد الدالة<code>min()‎</code> القيمة <code>NaN</code>: <syntaxhighlight lang="kotlin">
+
fun <T : Comparable<T>> Array<out T>.min(): T?  
fun <T : Comparable<T>> Array<out T>.max(): T?  
+
fun ByteArray.min(): Byte?  
fun ByteArray.max(): Byte?  
+
fun ShortArray.min(): Short?  
fun ShortArray.max(): Short?  
+
fun IntArray.min(): Int?  
fun IntArray.max(): Int?  
+
fun LongArray.min(): Long?  
fun LongArray.max(): Long?  
+
fun CharArray.min(): Char?  
fun CharArray.max(): Char?  
+
fun <T : Comparable<T>> Iterable<T>.min(): T?  
fun <T : Comparable<T>> Iterable<T>.max(): T?  
+
</syntaxhighlight>'''الإصدار المطلوب:''' Kotlin 1.1.
</syntaxhighlight>
+
==القيم المعادة==
==القيم المٌعادة==
+
يُعاد أصغر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة، أو القيمة <code>null</code> إن كانت تلك المصفوفة أو المجموعة فارغة، أو القيمة <code>NaN</code> إن كانت قيمة أيّ عنصر من العناصر تساوي <code>NaN</code>.
كبر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
 
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()min</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>()min</code> عبر <code>array</code>  للحصول على أكبر عدد فيها<nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
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.min()) // 0
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
===انظر أيضًا===
+
==انظر أيضًا==
*<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تضيف إلى [[Kotlin/collections/List|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] وفهارسها.
+
*الدالة <code>[[Kotlin/collections/max|max()]]</code>‎: تجلب أكبر عنصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 +
*الدالة <code>[[Kotlin/collections/minBy|minBy()‎]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.
 +
*الدالة <code>[[Kotlin/collections/minWith|minWith()‎]]</code>: تجلب العنصر أو الزوج الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى.
 
==مصادر==
 
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/max.html الدالة  min()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/min.html صفحة الدالة min()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 09:25، 8 سبتمبر 2018

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

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

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

fun <T : Comparable<T>> Array<out T>.min(): T? 
fun ByteArray.min(): Byte? 
fun ShortArray.min(): Short? 
fun IntArray.min(): Int? 
fun LongArray.min(): Long? 
fun CharArray.min(): Char? 
fun <T : Comparable<T>> Iterable<T>.min(): 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.min()) // 0
}

انظر أيضًا

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

مصادر