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

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

تتحقَّق الدالة singleOrNull()‎ من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة null خلاف ذلك.

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

fun CharSequence.singleOrNull(): Char? 
inline fun CharSequence.singleOrNull(
    predicate: (Char) -> Boolean
): Char?

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

المعاملات

`predicate`

دالة تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها محرفٌ وتعيد قيمة منطقية مقابله له.

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

يعاد المحرف الوحيد الموجود في سلسلة المحارف المعطاة، أو المحرف الوحيد الذي حقق الشرط predicate (إن أعطي)، أو تعاد القيمة null خلاف ذلك.

أمثلة

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

fun main(args: Array<String>) {
    println("w".singleOrNull()) // w
    println("wikiHsoub".singleOrNull { it.isUpperCase() }) // H
    println("WikiHsoub".singleOrNull { it.isUpperCase() }) // null
    println("wikihsoub".singleOrNull { it.isUpperCase() }) // null
}

انظر أيضًا

الدالة single()‎: تتحقَّق من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك.

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.singleOrNull()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.singleOrNull()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>singleOrNull()‎</code> الحرف الوحيد في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة أو تحتوي أكثر من حرف واحد فستطلق استثناء.
+تتحقَّق الدالة <code>singleOrNull()‎</code> من حواية <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة <code>null</code> خلاف ذلك.
-في حال تمرير شرط منطقي <code>predicate</code> كوسيط فستعيد الدالة <code>single()‎</code>الحرف الوحيد الذي يحقق ذلك الشرط. وفي حال لم يكن هناك أي حرف يحقق ذلك الشرط أو كان هناك أكثر من حرف واحد يحققه فستطلق استثناء.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.single(): Char
+fun CharSequence.singleOrNull(): Char?
+inline fun CharSequence.singleOrNull(
+    predicate: (Char) -> Boolean
+): Char?
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
-inline fun CharSequence.single(
+=== <code>predicate</code> ===
-    predicate: (Char) -> Boolean
+دالة تطبق على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إليها محرفٌ وتعيد قيمة منطقية مقابله له.
-): Char
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-[[Kotlin/Char/index|حرف]].
+يعاد المحرف الوحيد الموجود في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة، أو المحرف الوحيد الذي حقق الشرط <code>predicate</code> (إن أعطي)، أو تعاد القيمة <code>null</code> خلاف ذلك.
 ==أمثلة==
-===استخدام الدالة <code>()singleOrNull</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()singleOrNull</code>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()singleOrNull</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "H"
+    println("w".singleOrNull()) // w
+    println("wikiHsoub".singleOrNull { it.isUpperCase() }) // H
-println( str.single () ) // H
+    println("WikiHsoub".singleOrNull { it.isUpperCase() }) // null
+     println("wikihsoub".singleOrNull { it.isUpperCase() }) // null
 }
 </syntaxhighlight>
-===استخدام الدالة <code>()singleOrNull</code> مع سلسلة نصية مع تمرير دالة كوسيط===
+==انظر أيضًا==
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()singleOrNull</code> عبرها مع تمرير دالة كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+*الدالة <code>[[Kotlin/kotlin.text/single|single()]]‎</code>: تتحقَّق من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك.
-fun main(args: Array<String>) {
-val str = "Hsoub"
-println( str.single {it.isUpperCase()} ) // H
-}
-</syntaxhighlight>
-===استخدام الدالة <code>()singleOrNull</code> مع سلسلة نصية مع تمرير دالة كوسيط: الحالة الثانية===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()singleOrNull</code> عبرها مع تمرير دالة كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-val str = "hsoub"
-println( str.single {it.isUpperCase()} ) // إطلاق استثناء
-}
-</syntaxhighlight>
-== انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/elementAtOrElse|elementAtOrElse()]]‎</code>:تعيد الحرف الموجود في الفهرس المُحدّد في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال كان الفهرس خارج الحدود فستعيد ناتج تمرير ذلك الفهرس إلى الدالة المُمررة <code>defaultValue.</code>
-* <code>[[Kotlin/kotlin.text/drop|drop()]]‎</code>: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف أول <code>n</code> حرفًا.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+* الدالة <code>[[Kotlin/kotlin.text/elementAtOrNull|elementAtOrNull()‎]]</code>: تجلب محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/kotlin.text/getOrNull|getOrNull()]]‎</code>: تجلب محرفًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها أو تعيد القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]].
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/single.html الدالة text.singleOrNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/single-or-null.html صفحة الدالة CharSequence.singleOrNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]