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

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

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

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

fun CharSequence.single(): Char 

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

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

المعاملات

`predicate`

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

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

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

أمثلة

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

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

مثالٌ آخر على استعمال الدالة ()single عندما يكون هنالك أكثر من محرف محقق لشرط معين:

fun main(args: Array<String>) {
    println("HSoub".single { it.isUpperCase() })
}

يعطي هذا المثال عند تنفيذه الناتج التالي:

Exception in thread "main" java.lang.IllegalArgumentException: Char sequence contains more than one matching element.
at TestKt.main(test.kt:9)

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.single()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.single()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>single()‎</code> الحرف الموجود في الفهرس المُحدّد في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>.
+تتحقَّق الدالة <code>single()‎</code> من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك.
-==البنية العامة==
+== البنية العامة ==
 <syntaxhighlight lang="kotlin">
-inline fun CharSequence.elementAt(index: Int): Char
+fun CharSequence.single(): Char
+inline fun CharSequence.single(
+    predicate: (Char) -> Boolean
+): Char
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة]] (inline functions)).
+== المعاملات ==
+=== <code>predicate</code> ===
+دالة تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها محرفٌ وتعيد قيمة منطقية مقابله له.
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+== القيم المعادة ==
+يعاد المحرف الوحيد الموجود في سلسلة المحارف المعطاة، أو المحرف الوحيد الذي حقق الشرط <code>predicate</code> (إن أعطي)، أو يُطلق استثناءٌ خلاف ذلك.
-==القيم المعادة==
+== أمثلة ==
-[[Kotlin/Char/index|حرف]].
+مثالٌ على استعمال الدالة <code>()single</code>:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    println("w".single()) // w
+    println("wikiHsoub".single { it.isUpperCase() }) // H
+}
-==أمثلة==
+</syntaxhighlight>مثالٌ آخر على استعمال الدالة <code>()single</code> عندما يكون هنالك أكثر من محرف محقق لشرط معين:<syntaxhighlight lang="kotlin">
-===استخدام الدالة <code>()single</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()single</code> عبرها مع تمرير عدد كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "wiki Hsoub"
+    println("HSoub".single { it.isUpperCase() })
-println(str.elementAt(2)) //  k
 }
+</syntaxhighlight>يعطي هذا المثال عند تنفيذه الناتج التالي:<syntaxhighlight lang="text">
+Exception in thread "main" java.lang.IllegalArgumentException: Char sequence contains more than one matching element.
+at TestKt.main(test.kt:9)
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/elementAtOrElse|elementAtOrElse()]]‎</code>:تعيد الحرف الموجود في الفهرس المُحدّد في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال كان الفهرس خارج الحدود فستعيد ناتج تمرير ذلك الفهرس إلى الدالة المُمررة <code>defaultValue.</code>
+* الدالة <code>[[Kotlin/kotlin.text/singleOrNull|singleOrNull()‎]]</code>: تتحقَّق من حواية <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة <code>null</code> خلاف ذلك.
+* الدالة <code>[[Kotlin/kotlin.text/getOrElse|getOrElse()]]‎</code>: تجلب محرفًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.
+* الدالة <code>[[Kotlin/kotlin.text/filter|filter()‎]]</code>: ترشِّح محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.
-* <code>[[Kotlin/kotlin.text/drop|drop()]]‎</code>: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف أول <code>n</code> حرفًا.
+== مصادر ==
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/single.html صفحة الدالة CharSequence.single()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
-==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/element-at.html الدالة text.single()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]