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

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

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

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

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

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

المعاملات

`comparator`

دالةٌ تمثل الموزان الذي سيُطبَّق على كل محرف من محارف السلسلة المعطاة.

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

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

أمثلة

مثال عن استعمال الدالة maxWith()‎:

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

    print(str.maxWith(comp)) // H
}

انظر أيضًا

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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.maxWith()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.maxWith()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>maxWith()</code>‎ أول حرف  في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها والذي يعيد أكبر قيمة بعد تمريره إلى الدالة <code>selector</code> أو تعيد <code>null</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة.
+تجلب الدالة <code>maxWith()‎</code> المحرف الأول من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن <code>comparator</code> المعطى.
 ==البنية العامة==
 <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)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>comparator</code> ===
+دالةٌ تمثل الموزان الذي سيُطبَّق على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة.
 ==القيم المعادة==
-[[Kotlin/Char/index|حرف]].
+يُعاد المحرف الأول من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة والذي له أكبر قيمة بحسب الدالة <code>comparator</code> الموازنة المعطاة، أو القيمة <code>null</code> إن لم يكن هنالك أي عنصر.
 ==أمثلة==
-===استخدام الدالة <code>maxWith()‎</code> مع السلاسل النصية===
+مثال عن استعمال الدالة <code>maxWith()‎</code>:<syntaxhighlight lang="kotlin">
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>maxWith()‎</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>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/min|min()]]‎</code>: تعيد الدالة <code>min()</code>‎ أصغر حرف في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها أو تعيد <code>null</code> إن كانت فارغة.
+*الدالة <code>[[Kotlin/kotlin.text/minWith|minWith()‎]]</code>: تجلب المحرف الأول من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى.
-* <code>[[Kotlin/kotlin.text/max|max()]]‎</code>: تعيد الدالة <code>max()</code>‎ أكبر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد <code>null</code> إن كانت فارغة.
-*<code>[[Kotlin/kotlin.text/minBy|minBy()]]‎</code>: تعيد الدالة <code>minBy()</code>‎ أول حرف  في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها والذي يعيد أصغر قيمة بعد تمريره إلى الدالة <code>selector</code> أو تعيد <code>null</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة.
+*الدالة <code>[[Kotlin/kotlin.text/max|max()]]‎</code>: تعيد أكبر محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
+*الدالة <code>[[Kotlin/kotlin.text/maxBy|maxBy()‎]]</code>: تجلب المحرف من <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
 ==مصادر==
-*[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 صفحة الدالة CharSequence.maxWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]