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

المراجعة الحالية بتاريخ 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
}

انظر أيضًا

الدالة contentHashCode()‎: تعيد شيفرة hash لمحتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.
التابع hashCode()‎: يعيد شيفرة hash للكائن الذي استُدعي معه.
الدالة contentDeepToString()‎: تعيد سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.
الدالة contentDeepEquals()‎: تتحقق من تساوي مصفوفتين بالعُمق، أي أنهما تحتويان على نفس العناصر وبنفس الترتيب.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepHashCode()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepHashCode()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>contentDeepHashCode()‎</code>التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
+تشِّفر الدالة <code>contentDeepHashCode()‎</code> محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]] إلى شيفرة Hash. تعامل [[Kotlin/Array|المصفوفات]] المُتشعبة مثل [[Kotlin/List|القوائم]] أيضًا.
-ان احتوت [[Kotlin/Array|المصفوفة]] نفسها في أي مستوى من المستويات المتشعبة فإن سلوك الدالة سيكون غير محدد.
+إن حَوَت [[Kotlin/Array|المصفوفة]] نفسها في أي مستوى من المستويات المتشعبة، فسيكون سلوك الدالة غير محدَّد.
 ==البنية العامة==
@@ سطر 10: / سطر 10: @@
 </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|توثيق الدوال المباشرة]]).
 == القيم المعادة ==
- تعيد التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
+ شيفرة Hash لمحتوى [[Kotlin/Array|المصفوفة]] المعطاة كما لو كانت [[Kotlin/List|قائمة]].
 ==أمثلة==
-===استخدام الدالة <code>()contentDeepHashCode</code> مع المصفوفات ===
+===استخدام الدالة <code>()contentDeepHashCode</code> مع المصفوفات المتشعبة ===
-تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من أربعة أعداد  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentDeepHashCode</code> للحصول على تكويد [[Kotlin/Array|المصفوفة]] ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()contentDeepHashCode</code> للحصول على شيفرة Hash تلك المصفوفة:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(1,2,3,4)
+    val array = arrayOf(
+        intArrayOf(3, 7, 9),
-println(array.contentDeepHashCode()) // 955331
+        intArrayOf(0, 1, 0),
+        intArrayOf(2, 4, 8)
+    )
+    println(array.contentDeepHashCode()) // 32603018
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/collections/contentDeepToString|contentDeepToString()]]</code>‎:تعيد تمثيلًا نصيًا  استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
+*الدالة <code>[[Kotlin/collections/contentHashCode|contentHashCode()]]</code>‎: تعيد شيفرة hash لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]].
-*<code>[[Kotlin/collections/contentHashCode|contentHashCode()]]</code>‎:تعيد التكويد (hash code) استنادًا إلى محتوى [[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-deep-hash-code.html الدالة  contentDeepHashCode()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-deep-hash-code.html صفحة الدالة contentDeepHashCode()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]