الدالة CharSequence.singleOrNull()‎ في Kotlin

تتحقَّق الدالة 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.