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

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

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

@@ سطر 43: / سطر 43: @@
 </syntaxhighlight>
 ==انظر أيضًا==
+* الدالة [[Kotlin/kotlin.text/regionMatches|<code>regionMatches()</code>‎]]: تتحقق من مطابقة جزأين من [[Kotlin/String|سلسلتين نصيتين]] أو [[Kotlin/CharSequence/index|سلسلتين من المحارف]] محددين ببداية وطول مع بعضهما بعضًا.
 * الدالة <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: توازن بين [[Kotlin/String|سلسلتين نصيتين]] معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
 * الدالة <code>[[Kotlin/kotlin.text/contentEquals|contentEquals()‎]]</code>: تتحقق من تساوي محتوى [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها مع محتوى [[Kotlin/CharSequence|سلسلة المحارف]] أو الكائن <code>[[Kotlin/kotlin.text/StringBuffer|StringBuffer]]</code> المُمرّر إليها.
 * الدالة <code>[[Kotlin/kotlin.text/codePointAt|commonPrefixWith()]]‎</code>: تعيد أطول بادئة (prefix) مُشتركة بين [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
+* الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
+* الدالة <code>[[Kotlin/kotlin.text/matches|matches()]]‎</code>: تتحقق من مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها.
 ==مصادر==