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