الفرق بين المراجعتين ل"Kotlin/kotlin.text/elementAtOrElse"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.elementAtOrElse()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>elementAtOrElse()‎</code>...')
 
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 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">
 
<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>) {
 
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>
 
</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]]
−
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 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() }) // 
}

انظر أيضًا

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/elementAtOrElse&oldid=16390"