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

مراجعة 09:30، 5 يوليو 2018

تتحقَّق الدالة contentEquals()‎ من تساوي مصفوفتين بنيويًا (structurally equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب.

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

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 يدل على أنَّ الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة)، ووجود الكلمة المفتاحية infix يدل على إمكانية استدعاء الدالة بنمط التدوين الداخلي (Infix notation)، أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً (راجع للمزيد من التفاصيل توثيق التدوين الداخلي).

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

تُعاد القيمة المنطقية true إن كانت المصفوفتان المحددتان متساويتان بنيويًا (structurally equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب، أو القيمة false خلاف ذلك.

أمثلة

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

تعرِّف الشيفرة الآتية مصفوفتين لهما نفس العناصر وبنفس العدد والترتيب باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()contentEquals للتحقق من أنّ هاتين المصفوفتين متساويتان بنيويًّا:

fun main(args: Array<String>) {
    val array1 = arrayOf(1, 2, 3, 4)
    val array2 = arrayOf(1, 2, 3, 4)

    println(array1.contentEquals(array2)) // true
}

استخدام الدالة `()contentEquals` مع مصفوفتين غير متساويتين

تعرِّف الشيفرة الآتية مصفوفتين لهما عناصر مختلفة باستخدام الدالة ()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()‎: تتحقَّق من تساوي مصفوفتين بالعُمق، أي أنَّهما تحتويان على نفس العناصر وبنفس الترتيب.
الدالة contentToString()‎: تعيد سلسلة نصية تمثل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.
الدالة contentHashCode()‎: تعيد شيفرة hash لمحتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.

مصادر

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

@@ سطر 33: / سطر 33: @@
 </syntaxhighlight>
-'''الإصدار المطلوب: Kotlin 1.1'''
+'''الإصدار المطلوب:''' Kotlin 1.1
 وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة)]]، ووجود الكلمة المفتاحية <code>infix</code> يدل على إمكانية استدعاء الدالة بنمط التدوين الداخلي (Infix notation)، أي من خلال حذف المعامل <code>.</code> والأقواس <code>()</code> المُستخدَمَين في الاستدعاء عادةً (راجع للمزيد من التفاصيل <nowiki/>[[Kotlin/functions#.D8.A7.D9.84.D8.AA.D8.AF.D9.88.D9.8A.D9.86 .D8.A7.D9.84.D8.AF.D8.A7.D8.AE.D9.84.D9.8A.D9.91 .28Infix notation.29|توثيق التدوين الداخلي)]].
 ==القيم المعادة ==
-القيمة المنطقية <code>true</code> إن كانت المصفوفتان المحددتان متساويتان بنيويًا (''structurally'' equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب، أو القيمة <code>false</code> خلاف ذلك.
+تُعاد القيمة المنطقية <code>true</code> إن كانت المصفوفتان المحددتان متساويتان بنيويًا (''structurally'' equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب، أو القيمة <code>false</code> خلاف ذلك.
 ==أمثلة==
 ===استخدام الدالة <code>()contentEquals</code> مع مصفوفتين متساويتين ===
 تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفتين]] لهما نفس العناصر وبنفس العدد والترتيب باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()contentEquals</code> للتحقق من أنّ هاتين المصفوفتين متساويتان بنيويًّا:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(1,2,3,4)
+    val array1 = arrayOf(1, 2, 3, 4)
-val array2 = arrayOf(1,2,3,4)
+    val array2 = arrayOf(1, 2, 3, 4)
-println(array.contentEquals(array2)) // true
+    println(array1.contentEquals(array2)) // true
 }
 </syntaxhighlight>
@@ سطر 52: / سطر 52: @@
 تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفتين]] لهما عناصر مختلفة باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()contentEquals</code> لمعرفة إن كانت هاتين المصفوفتين متساويتان بنيويًّا:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(1,2,3,4)
+    val array = arrayOf(1, 2, 3, 4)
-val array2 = arrayOf(1,2,3,6)
+    val array2 = arrayOf(1, 2, 3, 6)
-println(array.contentEquals(array2)) // false
+    println(array.contentEquals(array2)) // false
 }
 </syntaxhighlight>
@@ سطر 64: / سطر 64: @@
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-equals.html الدالة  contentEquals()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-equals.html الدالة contentEquals()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]