الدالة contentEquals() في لغة Kotlin
تعيد الدالة contentEquals() االقيمة true إن كانت المصفوفتان المحددتان متساويتان بنيويًا (structurally equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد false خلاف ذلك.
البنية العامة
inline infix fun <T> Array<out T>.contentEquals(
other: Array<out T>
): Boolean
inline infix fun ByteArray.contentEquals(
other: ByteArray
): Boolean
inline infix fun ShortArray.contentEquals(
other: ShortArray
): Boolean
inline infix fun IntArray.contentEquals(
other: IntArray
): Boolean
inline infix fun LongArray.contentEquals(
other: LongArray
): Boolean
inline infix fun FloatArray.contentEquals(
other: FloatArray
): Boolean
inline infix fun DoubleArray.contentEquals(
other: DoubleArray
): Boolean
inline infix fun BooleanArray.contentEquals(
other: BooleanArray
): Boolean
inline infix fun CharArray.contentEquals(
other: CharArray
): Boolean
الإصدار المطلوب: Kotlin 1.1
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
ويُلاحَظ كذلك وجود الكلمة المفتاحية infix للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخلي (Infix notation)، أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع توثيق التدوين الداخلي (infix functions).
القيم المعادة
true إن كانت المصفوفتان المحددتان متساويتان بنيويًا (structurally equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد false خلاف ذلك.
أمثلة
استخدام الدالة ()contentEquals مع مصفوفتين متساويتين
تعرف الشيفرة الآتية مصفوفتين لهما نفس عدد العناصر ونفس العناصر بنفس الترتيب باسم array و array2مكونتان من أربعة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()contentEquals للتحقق من أنّ الحرفين المصفوفتين متساويتين بعمق ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4)
val array2 = arrayOf(1,2,3,4)
println(array.contentEquals(array2)) // true
}
استخدام الدالة ()contentEquals مع مصفوفتين غير متساويتين
تعرف الشيفرة الآتية مصفوفتين لهما نفس عدد العناصر ولكن تختلفان في أحد العناصر ب باسم array و array2 مكونة من أربعة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()contentEquals للتحقق من أنّ الحرفين المصفوفتين متساويتين بعمق ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4)
val array2 = arrayOf(1,2,3,6)
println(array.contentEquals(array2)) // false
}
انظر أيضًا
contentDeepEquals(): تعيد القيمةtrueإن كانت المصفوفتان المحددتان متساويتان بنيويًا (structurally equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيدfalseخلاف ذلك. وتعمل على المستويات المتشعبة كذلك.