الدالة CharSequence.single() في Kotlin
< Kotlin | kotlin.text
تتحقَّق الدالة 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(): ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.