الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/maxWith»

مراجعة 14:43، 10 يوليو 2018

تعيد الدالة maxWith()‎ أول حرف في سلسلة الحروف التي استٌدعيت عبرها والذي له أكبر قيمة نسبة إلى المُقارِن comparator أو تعيد null إن كانت سلسلة الحروف فارغة.

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

fun CharSequence.maxWith(
    comparator: Comparator<in Char>
): Char?

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

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

حرف.

أمثلة

استخدام الدالة `maxWith()‎` مع السلاسل النصية

تُعرّف الشيفرة الآتية سلسلة نصية باسم str، وتعرّف مقارنًا باسم comp، ثم تستدعي الدالة maxWith()‎ عبر str مع تمرير comp، ثم تطبع الناتج:

fun main(args: Array<String>) {
val str = "HsoubWiki" 
val comp = Comparator {x:Char, y:Char -> y.toInt() - x.toByte()}
    
print( str.maxWith (comp) ) // H
}

انظر أيضًا

min()‎: تعيد الدالة min()‎ أصغر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد null إن كانت فارغة.

max()‎: تعيد الدالة max()‎ أكبر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد null إن كانت فارغة.

minBy()‎: تعيد الدالة minBy()‎ أول حرف في سلسلة الحروف التي استٌدعيت عبرها والذي يعيد أصغر قيمة بعد تمريره إلى الدالة selector أو تعيد null إن كانت سلسلة الحروف فارغة.

مصادر

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

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