الفرق بين المراجعتين لصفحة: «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.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.contains()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.contains()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>contains()‎</code> القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها تحتوي [[Kotlin/Char/index|الحرف]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]]  المُمرّرة. الوسيط <code>ignoreCase</code> يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.
+تتحقق الدالة <code>contains()‎</code> إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تحوي [[Kotlin/Char|المحرف]] أو [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها. إن مُرِّر [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] إلى هذه الدالة، فستتحقق إن كانت [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها تحوي محرفًا واحدًا على الأقل متطابقًا مع ذلك [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]].
-في حال تمرير [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] فستعيد الدالةُ القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها تحتوي على الأقل مطابقة واحدة لذلك [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]].
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 18: / سطر 16: @@
      regex: Regex
 ): Boolean
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>other</code> ===
+[[Kotlin/CharSequence|سلسلة المحارف]] المراد معرفة إن كانت موجودة ضمن [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة.
+=== <code>char</code> ===
+[[Kotlin/Char|المحرف]] المراد التحقق من وجوده ضمن [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة.
+=== <code>regex</code> ===
+[[Kotlin/kotlin.text/Regex|التعبير النمطي]] المراد التحقق من مطابقته لمحرف واحد على الأقل من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة.
+=== <code>ignoreCase</code> ===
+قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء تنفيذ عملية التحقق. القيمة الافتراضية هي: <code>false</code> أي أخذ حالة الحروف بالحسبان.
 ==القيم المعادة==
-قيمة منطقية.
+تعاد القيمة <code>true</code> إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة تحوي [[Kotlin/CharSequence|سلسلة المحارف]] <code>other</code>، أو [[Kotlin/Char|المحرف]] <code>char</code>، أو مطابقةً واحدة على الأقل مع [[Kotlin/kotlin.text/Regex|التعبير النمطي]] <code>regex</code>، أو تعاد القيمة <code>false</code> خلاف ذلك.
 ==أمثلة==
-===استخدام الدالة <code>()contains</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()contains</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()contains</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val str = "hsoub"
+     val str = "WikiHsoub"
-     println(str.contains("sou")) // => true
+     println(str.contains("wiki")) // => false
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
+* الدالة [[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/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
+* الدالة <code>[[Kotlin/kotlin.text/contentEquals|contentEquals()‎]]</code>: تتحقق من تساوي محتوى [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها مع محتوى [[Kotlin/CharSequence|سلسلة المحارف]] أو الكائن <code>[[Kotlin/kotlin.text/StringBuffer|StringBuffer]]</code> المُمرّر إليها.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</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|التعبير النمطي]] الذي استدعي معها.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/contains.html الدالة text.contains()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/contains.html صفحة الدالة CharSequence.contains()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]