الفرق بين المراجعتين لصفحة: «Kotlin/collections/contentEquals»
< Kotlin | collections
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>contentEquals()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>contentEquals()</code> في لغة Kotlin}}</noinclude> | ||
تعيد الدالة <code>contentEquals()</code> | تعيد الدالة <code>contentEquals()</code> االقيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
inline infix fun <T> Array<out T>. | inline infix fun <T> Array<out T>.contentEquals( | ||
other: Array<out T> | 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 | ): Boolean | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 14: | سطر 36: | ||
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
ويُلاحَظ كذلك وجود الكلمة المفتاحية <code>infix</code> للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخلي (Infix notation)، أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع <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|توثيق التدوين الداخلي (infix functions)]]. | |||
==القيم المعادة== | ==القيم المعادة== | ||
<code>true</code> | <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك. | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>() | ===استخدام الدالة <code>()contentEquals</code> مع مصفوفتين متساويتين === | ||
تعرف الشيفرة الآتية مصفوفتين لهما نفس عدد العناصر ونفس العناصر بنفس الترتيب باسم <code>array</code> و <code>array2</code>مكونتان من أربعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>() | تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفتين]] لهما نفس عدد العناصر ونفس العناصر بنفس الترتيب باسم <code>array</code> و <code>array2</code>مكونتان من أربعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentEquals</code> للتحقق من أنّ الحرفين المصفوفتين متساويتين بعمق ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | 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,4) | val array2 = arrayOf(1,2,3,4) | ||
println(array. | println(array.contentEquals(array2)) // true | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===استخدام الدالة <code>() | ===استخدام الدالة <code>()contentEquals</code> مع مصفوفتين غير متساويتين === | ||
تعرف الشيفرة الآتية مصفوفتين لهما نفس عدد العناصر ولكن تختلفان في أحد العناصر ب باسم <code>array</code> و <code>array2</code> مكونة من أربعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>() | تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفتين]] لهما نفس عدد العناصر ولكن تختلفان في أحد العناصر ب باسم <code>array</code> و <code>array2</code> مكونة من أربعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentEquals</code> للتحقق من أنّ الحرفين المصفوفتين متساويتين بعمق ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | 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. | println(array.contentEquals(array2)) // false | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
*<code>[[Kotlin/collections/contentDeepEquals| | *<code>[[Kotlin/collections/contentDeepEquals|contentDeepEquals()]]</code>: تعيد القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك. وتعمل على المستويات المتشعبة كذلك. | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/ | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-equals.html الدالة contentEquals() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 18:54، 12 مايو 2018
تعيد الدالة 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خلاف ذلك. وتعمل على المستويات المتشعبة كذلك.