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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.contentEquals()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>contentEquals()‎</code> ال...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.contentEquals()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>text.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> القيمة <code>true</code> إن كانت [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها تساوي [[Kotlin/CharSequence/index|سلسلة الحروف]] أو الكائن (<code>StringBuffer</code>) المُمرّر.   
 
في حال تمرير [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] فستعيد الدالةُ القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها تحتوي على الأقل مطابقة واحدة لذلك [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]].   
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
operator fun CharSequence.contains(
inline fun String.contentEquals(
     other: CharSequence,
     charSequence: CharSequence
    ignoreCase: Boolean = false
): Boolean
): Boolean


operator fun CharSequence.contains(
inline fun String.contentEquals(
     char: Char,
     stringBuilder: StringBuffer
    ignoreCase: Boolean = false
): Boolean
): Boolean
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''


inline operator fun CharSequence.contains(
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
    regex: Regex
): Boolean
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].


==القيم المعادة==
==القيم المعادة==
سطر 28: سطر 22:
     val str = "hsoub"
     val str = "hsoub"


     println(str.contains("sou")) // => true
     println(str.contentEquals("hsoub")) // => true
    println(str.contentEquals("abc")) // => false
 
}
}
</syntaxhighlight>
</syntaxhighlight>
===انظر أيضًا===
===انظر أيضًا===
* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
* <code>[[Kotlin/kotlin.text/contains|contains()]]‎</code>: تعيد القيمة <code>true</code> إن كانت سلسلة الحروف التي استُدعيت عبرها تحتوي الحرف أو سلسلة الحروف المُمرّرة. الوسيط<code>ignoreCase</code> يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.


* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
سطر 38: سطر 34:


==مصادر==
==مصادر==
*[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 الدالة text.contentEquals()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 13:46، 8 يوليو 2018

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

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

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

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

بيئة التشغيل المطلوبة: JVM

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

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

قيمة منطقية.

أمثلة

استخدام الدالة ()contentEquals مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()contentEquals عبرها مع تمرير سلسلة نصية كوسيط، ثمَّ تطبع الناتج:

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

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

}

انظر أيضًا

  • contains(): تعيد القيمة true إن كانت سلسلة الحروف التي استُدعيت عبرها تحتوي الحرف أو سلسلة الحروف المُمرّرة. الوسيطignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.
  • compareTo(): تقارن بين سلسلتين نصيتين.
  • asSequence(): تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر