الفرق بين المراجعتين ل"Kotlin/kotlin.text/minBy"

المراجعة الحالية بتاريخ 11:32، 4 سبتمبر 2018

تجلب الدالة minBy()‎ المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.

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

inline fun <R : Comparable<R>> CharSequence.minBy(
    selector: (Char) -> R
): Char?

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

`selector`

دالةٌ تطبَّق على كل محرف من محارف السلسلة المعطاة. يمرر إليها المحرف، وتعيد قيمة مقابلة له.

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

يعاد المحرف من السلسلة المعطاة والذي أعطى أصغر قيمة عند تطبيق الدالة selector عليه، أو تُعاد القيمة null إن لم يكن هناك أي محرف.

أمثلة

مثال على استعمال الدالة minBy()‎:

fun main(args: Array<String>) {
    val str = "HsoubWiki"

    print(str.minBy { it.toUpperCase() }) // b
}

انظر أيضًا

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

مصادر

صفحة الدالة text.minBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.minBy()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.minBy()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>minBy()</code>‎ أول حرف  في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها يعيد أكبر قيمة بعد تمريره إلى الدالة <code>selector</code> أو تعيد <code>null</code> إن كانت فارغة.
+تجلب الدالة <code>minBy()‎</code> المحرف من <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun <R : Comparable<R>> CharSequence.maxBy(
+inline fun <R : Comparable<R>> CharSequence.minBy(
      selector: (Char) -> R
 ): Char?
-</syntaxhighlight>
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>selector</code> ===
+دالةٌ تطبَّق على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إليها المحرف، وتعيد قيمة مقابلة له.
 ==القيم المعادة==
-[[Kotlin/Char/index|حرف]].
+يعاد المحرف من [[Kotlin/CharSequence|السلسلة]] المعطاة والذي أعطى أصغر قيمة عند تطبيق الدالة <code>selector</code> عليه، أو تُعاد القيمة <code>null</code> إن لم يكن هناك أي محرف.
 ==أمثلة==
-===استخدام الدالة <code>minBy()‎</code> مع السلاسل النصية===
+مثال على استعمال الدالة <code>minBy()‎</code>:<syntaxhighlight lang="kotlin">
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>minBy()‎</code> عبرها مع تمريل، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "Hsoub Wiki"
+    val str = "HsoubWiki"
-print( str.maxBy {it.toUpperCase()} ) // W
+     print(str.minBy { it.toUpperCase() }) // b
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/min|min()]]‎</code>: تعيد الدالة <code>min()</code>‎ أصغر حرف في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها أو تعيد <code>null</code> إن كانت فارغة.
+*الدالة <code>[[Kotlin/kotlin.text/maxBy|maxBy()‎]]</code>: تجلب المحرف من <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
+*الدالة <code>[[Kotlin/kotlin.text/min|min()‎]]</code>: تجلب أصغر محرف في [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
-* <code>[[Kotlin/kotlin.text/max|max()]]‎</code>: تعيد الدالة <code>max()</code>‎ أكبر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد <code>null</code> إن كانت فارغة.
+*الدالة <code>[[Kotlin/kotlin.text/minWith|minWith()‎]]</code>: تجلب المحرف الأول من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى.
-*<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]‎</code>: تعيد  [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/max-by.html صفحة الدالة text.minBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/min-by.html صفحة الدالة text.minBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]