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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepHashCode()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>contentDeepHashCode()‎</code...'
 
طلا ملخص تعديل
 
(8 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepHashCode()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepHashCode()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>contentDeepHashCode()‎</code> االقيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك.   
تشِّفر الدالة <code>contentDeepHashCode()‎</code> محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]] إلى شيفرة Hash. تعامل [[Kotlin/Array|المصفوفات]] المُتشعبة مثل [[Kotlin/List|القوائم]] أيضًا. 
 
إن حَوَت [[Kotlin/Array|المصفوفة]] نفسها في أي مستوى من المستويات المتشعبة، فسيكون سلوك الدالة غير محدَّد.   


==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline infix fun <T> Array<out T>.contentEquals(
inline fun <T> Array<out T>.contentDeepHashCode(): Int
    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
</syntaxhighlight>
</syntaxhighlight>


<u>'''الإصدار المطلوب: Kotlin 1.1'''</u>
'''الإصدار المطلوب:''' Kotlin 1.1


يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/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)]].
== القيم المعادة ==
==القيم المعادة==
 شيفرة Hash لمحتوى [[Kotlin/Array|المصفوفة]] المعطاة كما لو كانت [[Kotlin/List|قائمة]].
 <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك.  
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()contentEquals</code> مع مصفوفتين متساويتين ===
===استخدام الدالة <code>()contentDeepHashCode</code> مع المصفوفات المتشعبة ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفتين]] لهما نفس عدد العناصر ونفس العناصر بنفس الترتيب باسم <code>array</code> و <code>array2</code>مكونتان من أربعة أعداد  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentEquals</code> للتحقق من أنّ الحرفين المصفوفتين متساويتين بعمق ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()contentDeepHashCode</code> للحصول على شيفرة Hash تلك المصفوفة:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4)
    val array = arrayOf(
val array2 = arrayOf(1,2,3,4)
        intArrayOf(3, 7, 9),
 
        intArrayOf(0, 1, 0),
println(array.contentEquals(array2)) // true
        intArrayOf(2, 4, 8)
}
    )
</syntaxhighlight>
    println(array.contentDeepHashCode()) // 32603018
===استخدام الدالة <code>()contentDeepHashCode</code> مع مصفوفتين غير متساويتين ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفتين]] لهما نفس عدد العناصر ولكن تختلفان في أحد العناصر ب باسم <code>array</code> و <code>array2</code> مكونة من أربعة أعداد  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentEquals</code> للتحقق من أنّ الحرفين المصفوفتين متساويتين بعمق ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4)
val array2 = arrayOf(1,2,3,6)
 
println(array.contentEquals(array2)) // false
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
==انظر أيضًا==
*<code>[[Kotlin/collections/contentDeepEquals|contentDeepEquals()]]</code>‎: تعيد القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر  ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك.  وتعمل على المستويات المتشعبة كذلك.  
*الدالة <code>[[Kotlin/collections/contentHashCode|contentHashCode()]]</code>‎: تعيد شيفرة hash لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]].
*التابع <nowiki/>[[Kotlin/Any/hashCode|<code>hashCode()</code>‎]]: يعيد شيفرة hash للكائن الذي استُدعي معه.
*الدالة <code>[[Kotlin/collections/contentDeepToString|contentDeepToString()]]</code>‎: تعيد سلسلة نصية تمثِّل محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]].
*الدالة <code>[[Kotlin/collections/contentDeepEquals|contentDeepEquals()‎]]</code>: تتحقق من تساوي مصفوفتين بالعُمق، أي أنهما تحتويان على نفس العناصر وبنفس الترتيب.  


==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-equals.html الدالة  contentEquals()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-deep-hash-code.html صفحة الدالة contentDeepHashCode()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 07:27، 8 سبتمبر 2018

تشِّفر الدالة contentDeepHashCode()‎ محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash. تعامل المصفوفات المُتشعبة مثل القوائم أيضًا.

إن حَوَت المصفوفة نفسها في أي مستوى من المستويات المتشعبة، فسيكون سلوك الدالة غير محدَّد.

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

inline fun <T> Array<out T>.contentDeepHashCode(): Int

الإصدار المطلوب: Kotlin 1.1

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

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

 شيفرة Hash لمحتوى المصفوفة المعطاة كما لو كانت قائمة.

أمثلة

استخدام الدالة ()contentDeepHashCode مع المصفوفات المتشعبة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()contentDeepHashCode للحصول على شيفرة Hash تلك المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(
        intArrayOf(3, 7, 9),
        intArrayOf(0, 1, 0),
        intArrayOf(2, 4, 8)
    )
    println(array.contentDeepHashCode()) // 32603018
}

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/collections/contentDeepHashCode&oldid=17081»