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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.minBy()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>minBy()</code>‎ أول حرف في Kotlin/Strin...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.minBy()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع text.minBy()‎ في لغة Kotlin}}</noinclude>
تعيد الدالة <code>minBy()</code>‎ أول حرف  في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها يعيد أكبر قيمة بعد تمريره إلى الدالة <code>selector</code> أو تعيد <code>null</code> إن كانت فارغة.
تعيد الدالة <code>minBy()</code>‎ أول حرف  في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها والذي يعيد أصغر قيمة بعد تمريره إلى الدالة <code>selector</code> أو تعيد <code>null</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun <R : Comparable<R>> CharSequence.maxBy(
inline fun <R : Comparable<R>> CharSequence.minBy(
     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>minBy()‎</code> مع السلاسل النصية===
===استخدام الدالة <code>minBy()‎</code> مع السلاسل النصية===
تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>minBy()‎</code> عبرها مع تمريل، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>minBy()‎</code> عبرها مع تمرير دالة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
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>
</syntaxhighlight>
سطر 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/mapIndexed|mapIndexed()]]‎</code>: تعيد  [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
*<code>[[Kotlin/kotlin.text/maxBy|maxBy()]]‎</code>: تعيد الدالة <code>maxBy()</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.minBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/min-by.html صفحة الدالة text.minBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Method]]

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

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

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

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

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

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

حرف.

أمثلة

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

تُعرّف الشيفرة الآتية سلسلة نصية باسم str، ثم تستدعي الدالة minBy()‎ عبرها مع تمرير دالة، ثم تطبع الناتج:

fun main(args: Array<String>) {
val str = "HsoubWiki" 
    
print( str.minBy {it.toUpperCase()} ) // b
}

انظر أيضًا

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

مصادر