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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.getOrNull()‎</code> في لغة Kotlin}}</noinclude> تُعيد الدالة<code>getOrNull()‎</code> الحرف...')
 
(مراجعة وتدقيق.)
 
(مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE: الدالة <code>text.getOrNull()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.getOrNull()‎</code> في Kotlin}}</noinclude>
−
تُعيد الدالة<code>getOrNull()‎</code> الحرف الموجود عند الفهرس المُمرّر  <code>index</code> في  [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، أو ناتج استدعاء الدالة المُمررة  <code>defaultValue</code> على ذلك الفهرس إن كان خارج الحدود.   
+
تجلب الدالة <code>getOrNull()‎</code> محرفًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها أو تعيد القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]].   
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
−
inline fun CharSequence.getOrElse(
+
fun CharSequence.getOrNull(index: Int): Char?
−
    index: Int,
+
 
−
    defaultValue: (Int) -> Char
+
</syntaxhighlight>
−
): Char
+
 
−
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
== المعاملات ==
 +
 
 +
=== <code>index</code> ===
 +
عدد صحيح يمثل فهرس المحرف المراد جلبه.
  
 
==القيم المعادة==
 
==القيم المعادة==
−
[[Kotlin/Char/index|حرف]].
+
يعاد المحرف ذو الفهرس <code>index</code> من [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة، أو تعاد القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]].
  
 
==أمثلة==
 
==أمثلة==
−
===استخدام الدالة <code>()getOrNull</code> مع سلسلة نصية===
+
مثالٌ على استعمال الدالة <code>()getOrNull</code><nowiki/>:<syntaxhighlight lang="kotlin">
−
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()getOrNull</code> عبرها مع تمرير عدد ودالة كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
−
val str = "Hsoub"
+
    val str = "Hsoub"
  
−
print(str.getOrElse(3) {it.toChar()}) // => u
+
    print(str.getOrNull(3)) // => u
−
print(str.getOrElse(100) {it.toChar()}) // => d
+
    print(str.getOrNull(5)) // => null
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
−
* <code>[[Kotlin/kotlin.text/foldIndexed|foldIndexed()]]‎</code>: تُراكِم الدالة<code>foldIndexed()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة الراهنة وعلى الحرف الموالي في  [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها  وكذلك فهرسه. ثم تُعيد القيمة النهائية. 
+
* الدالة <code>[[Kotlin/kotlin.text/getOrElse|getOrElse()]]‎</code>: تجلب محرفًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى يقع خارج حدود [[Kotlin/CharSequence|سلسلة المحارف]]، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.
−
 
+
* الدالة <code>[[Kotlin/kotlin.text/elementAtOrNull|elementAtOrNull()‎]]</code>: تجلب محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
−
* <code>[[Kotlin/kotlin.text/fold|fold()]]‎</code>: تُراكِم الدالة<code>fold()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة الراهنة وعلى الحرف الموالي في  سلسلة الحروف التي استُدعيت عبرها. ثم تُعيد القيمة النهائية. 
+
* الدالة <code>[[Kotlin/kotlin.text/first|first()]]‎</code>: تجلب أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
−
 
 
−
* <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>. 
 
  
 
==مصادر==
 
==مصادر==
−
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/get-or-else.html الدالة text.getOrNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/get-or-null.html صفحة الدالة CharSequence.getOrNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
−
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin CharSequence]]

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

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

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

fun CharSequence.getOrNull(index: Int): Char?

المعاملات

index

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

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

يعاد المحرف ذو الفهرس index من سلسلة المحارف المعطاة، أو تعاد القيمة null إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف.

أمثلة

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

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

    print(str.getOrNull(3)) // => u
    print(str.getOrNull(5)) // => null
}

انظر أيضًا

  • الدالة getOrElse()‎: تجلب محرفًا ذا فهرس مُحدَّد من سلسلة المحارف التي استُدعيت معها. إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.
  • الدالة elementAtOrNull()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
  • الدالة first()‎: تجلب أول محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

مصادر

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