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

المراجعة الحالية بتاريخ 13:55، 3 سبتمبر 2018

تجلب الدالة elementAtOrElse()‎ محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود سلسلة المحارف، فستُعيد الدالة ناتج استدعاء دالة معينة.

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

inline fun CharSequence.elementAtOrElse(
    index: Int, 
    defaultValue: (Int) -> Char
): Char

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

المعاملات

`index`

عدد صحيح يمثل فهرس المحرف المراد جلبه من سلسلة المحارف المعطاة.

`defaultValue`

دالةٌ تستدعى عندما يكون الفهرس index خارج حدود سلسلة المحارف.

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

يُعاد المحرف ذي الفهرس index والموجود ضمن نطاق سلسلة المحارف المعطاة، أو ناتج استدعاء الدالة defaultValue()‎ إن كان فهرس المحرف المعطى يقع خارج حدود سلسلة المحارف.

أمثلة

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

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

    println(str.elementAtOrElse(10) { it.toChar() }) // 
}

انظر أيضًا

الدالة elementAt()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
الدالة elementAtOrNull()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
الدالة getOrElse()‎: تجلب محرفًا ذا فهرس مُحدَّد من سلسلة المحارف التي استُدعيت معها. إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.
الدالة dropLast()‎: تُزيِل آخر n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.elementAtOrElse()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.elementAtOrElse()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>elementAtOrElse()‎</code> الحرف الموجود في الفهرس المُحدّد في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>.
+تجلب الدالة <code>elementAtOrElse()‎</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فستُعيد الدالة ناتج استدعاء دالة معينة.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun CharSequence.elementAt(index: Int): Char
+inline fun CharSequence.elementAtOrElse(
+    index: Int,
+    defaultValue: (Int) -> Char
+): Char
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+== المعاملات ==
+=== <code>index</code> ===
+عدد صحيح يمثل فهرس [[Kotlin/Char|المحرف]] المراد جلبه من [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة.
+=== <code>defaultValue</code> ===
+دالةٌ تستدعى عندما يكون الفهرس <code>index</code> خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]].
 ==القيم المعادة==
-[[Kotlin/Char/index|حرف]].
+يُعاد [[Kotlin/Char|المحرف]] ذي الفهرس <code>index</code> والموجود ضمن نطاق <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة، أو ناتج استدعاء الدالة <code>defaultValue()‎</code> إن كان فهرس المحرف المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]].
 ==أمثلة==
-===استخدام الدالة <code>()elementAtOrElse</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()elementAtOrElse</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()elementAtOrElse</code> عبرها مع تمرير عدد كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "wiki Hsoub"
+    val str = "wiki Hsoub"
-println(str.elementAt(2)) //  k
+     println(str.elementAtOrElse(10) { it.toChar() }) //
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/dropLast|dropLast()]]‎</code>: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف آخر <code>n</code> حرفًا.
+* الدالة <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تجلب محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
+*الدالة <code>[[Kotlin/kotlin.text/elementAtOrNull|elementAtOrNull()‎]]</code>: تجلب محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
-* <code>[[Kotlin/kotlin.text/drop|drop()]]‎</code>: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف أول <code>n</code> حرفًا.
+* الدالة <code>[[Kotlin/kotlin.text/getOrElse|getOrElse()]]‎</code>: تجلب محرفًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+*الدالة <code>[[Kotlin/kotlin.text/dropLast|dropLast()]]‎</code>: تُزيِل آخر <code>n</code> محرف من محارف <nowiki/>[[Kotlin/String|السلسلة النصية]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/element-at.html الدالة text.elementAtOrElse()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/element-at-or-else.html صفحة الدالة CharSequence.elementAtOrElse()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]