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

تتحقق الدالة contains()‎ إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها. إن مُرِّر تعبير نمطي إلى هذه الدالة، فستتحقق إن كانت سلسلة المحارف التي استُدعيت معها تحوي محرفًا واحدًا على الأقل متطابقًا مع ذلك التعبير النمطي.

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

operator fun CharSequence.contains(
    other: CharSequence, 
    ignoreCase: Boolean = false
): Boolean

operator fun CharSequence.contains(
    char: Char, 
    ignoreCase: Boolean = false
): Boolean 

inline operator fun CharSequence.contains(
    regex: Regex
): Boolean

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

المعاملات

other

سلسلة المحارف المراد معرفة إن كانت موجودة ضمن سلسلة المحارف المعطاة.

char

المحرف المراد التحقق من وجوده ضمن سلسلة المحارف المعطاة.

regex

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

ignoreCase

قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء تنفيذ عملية التحقق. القيمة الافتراضية هي: false أي أخذ حالة الحروف بالحسبان.

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

تعاد القيمة true إن كانت سلسلة المحارف المعطاة تحوي سلسلة المحارف other، أو المحرف char، أو مطابقةً واحدة على الأقل مع التعبير النمطي regex، أو تعاد القيمة false خلاف ذلك.

أمثلة

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

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

    println(str.contains("wiki")) // => false
}

انظر أيضًا

• الدالة regionMatches()‎: تتحقق من مطابقة جزأين من سلسلتين نصيتين أو سلسلتين من المحارف محددين ببداية وطول مع بعضهما بعضًا.
• الدالة compareTo()‎: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
• الدالة contentEquals()‎: تتحقق من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى سلسلة المحارف أو الكائن StringBuffer المُمرّر إليها.
• الدالة commonPrefixWith()‎: تعيد أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.
• الدالة containsMatchIn()‎: تتحقق إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه.
• الدالة matches()‎: تتحقق من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.

مصادر

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