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