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

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

تتحقق الدالة contentEquals()‎ من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى سلسلة المحارف أو الكائن StringBuffer المُمرّر إليها.

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

inline fun String.contentEquals(
    charSequence: CharSequence
): Boolean

inline fun String.contentEquals(
    stringBuilder: StringBuffer
): Boolean

منصة التشغيل المطلوبة: JVM.

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

المعاملات

`charSequence`

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

`StringBuilder`

كائن من النوع StringBuffer يراد التحقق من تساوي محتواه مع محتوى السلسلة النصية المعطاة.

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

تعاد القيمة true إن كان محتوى السلسلة النصية المعطاة متساويًا مع محتوى المعامل charSequence أو المعامل StringBuilder، أو تعاد القيمة false خلاف ذلك.

أمثلة

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

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

    println(str.contentEquals("hsoub")) // => true
    println(str.contentEquals("abc")) // => false

}

انظر أيضًا

الدالة contains()‎: تتحقق إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها.

الدالة concat()‎: تضيف السلسلة النصية التي استُدعيت معها إلى السلسلة النصية المُمرّرة إليها.
الدالة count()‎: تَعُدُّ جميع محارف سلسلة المحارف التي استُدعيت معها، أو المحارف المحققة لشرط معين.

مصادر

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

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