الدالة String.contentEquals()‎ في لغة Kotlin

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