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

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

تجلب الدالة max()‎ أكبر محرف من محارف السلسلة التي استُدعيت معها.

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

fun CharSequence.max(): Char?

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

يُعاد أكبر محرف من محارف السلسلة المعطاة، أو القيمة null إن كانت تلك السلسلة فارغة.

أمثلة

مثالٌ على استعمال الدالة max()‎:

fun main(args: Array<String>) {
    val str = "Hsoub"

    print(str.max()) // u
}

انظر أيضًا

الدالة min()‎: تعيد أصغر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد null إن كانت فارغة.
الدالة maxBy()‎: تجلب المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
الدالة maxWith()‎: تجلب المحرف الأول من سلسلة المحارف التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن comparator المعطى.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.max()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.max()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>max()</code>‎ القيمة <code>true</code> إن طابقت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها  التعبير النمطي المُمرّر <code>regex</code>.
+تجلب الدالة <code>max()‎</code> أكبر محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun String.matches(regex: String): Boolean
+fun CharSequence.max(): Char?
-inline infix fun CharSequence.matches(regex: Regex): Boolean
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>
 ==القيم المعادة==
-قيمة منطقية.
+يُعاد أكبر محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة، أو القيمة <code>null</code> إن كانت تلك [[Kotlin/CharSequence|السلسلة]] فارغة.
 ==أمثلة==
-===استخدام الدالة <code>max()‎</code> مع السلاسل النصية===
+مثالٌ على استعمال الدالة <code>max()‎</code>:<syntaxhighlight lang="kotlin">
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلتين نصيتين]] باسم <code>str</code> و <code>str2</code>، ثم تستدعي الدالة <code>max()‎</code> عبرهما وتمرر  [[Kotlin/String|سلسلة نصية]] كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "sds12ff"
+    val str = "Hsoub"
-val str2 = "sdsff"
+     print(str.max()) // u
-print( str.matches ("""-?\d+(\.\d+)?""") ) // true
-print( str2.matches ("""-?\d+(\.\d+)?""") ) // false
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/match|match()]]‎</code>: تعيد [[Kotlin/Array|مصفوفة]] مكونة من [[Kotlin/String|السلاسل النصية]] المُطابقة للتعبير النمطي المُمرّر <code>regex</code> في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.
+*الدالة <code>[[Kotlin/kotlin.text/min|min()]]‎</code>: تعيد أصغر حرف في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها أو تعيد <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>: تجلب المحرف من <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
+*الدالة <code>[[Kotlin/kotlin.text/maxWith|maxWith()‎]]</code>: تجلب  المحرف الأول من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن <code>comparator</code> المعطى.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/matches.html صفحة الدالة text.max()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/max.html صفحة الدالة CharSequence.max()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]