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

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

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

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

inline fun <T> Array<out T>.contentHashCode(): Int
inline fun ByteArray.contentHashCode(): Int
inline fun ShortArray.contentHashCode(): Int 
inline fun IntArray.contentHashCode(): Int 
inline fun LongArray.contentHashCode(): Int 
inline fun FloatArray.contentHashCode(): Int
inline fun DoubleArray.contentHashCode(): Int 
inline fun BooleanArray.contentHashCode(): Int 
inline fun CharArray.contentHashCode(): Int

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

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

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

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

أمثلة

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

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

    println(array.contentDeepHashCode()) // 955331
}

انظر أيضًا

الدالة contentDeepHashCode()‎: تعيد شيفرة hash لمحتوى المصفوفة التي استدعيت معها كما لو كانت قائمة.
التابع hashCode()‎: يعيد شيفرة Hash للكائن الذي استُدعي معه.
الدالة contentToString()‎: تعيد سلسلة نصية تمثل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.
الدالة contentEquals()‎: تتحقَّق إن كانت مصفوفتان متساويتين بنيويًا (structurally equal).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>contentHashCode()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>contentHashCode()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>contentHashCode()‎</code>التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
+تشفِّر الدالة <code>contentHashCode()‎</code> محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]] إلى شيفرة Hash.
-ان احتوت [[Kotlin/Array|المصفوفة]] نفسها في أي مستوى من المستويات المتشعبة فإن سلوك الدالة سيكون غير محدد.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun <T> Array<out T>.contentDeepHashCode(): Int
+inline fun <T> Array<out T>.contentHashCode(): Int
+inline fun ByteArray.contentHashCode(): Int
+inline fun ShortArray.contentHashCode(): Int
+inline fun IntArray.contentHashCode(): Int
+inline fun LongArray.contentHashCode(): Int
+inline fun FloatArray.contentHashCode(): Int
+inline fun DoubleArray.contentHashCode(): Int
+inline fun BooleanArray.contentHashCode(): Int
+inline fun CharArray.contentHashCode(): Int
 </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>()contentHashCode</code> مع المصفوفات ===
+تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()contentHashCode</code> للحصول على شيفرة Hash لهذه المصفوفة:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من أربعة أعداد  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentHashCode</code> للحصول على تكويد [[Kotlin/Array|المصفوفة]] ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(1,2,3,4)
+    val array = arrayOf(1, 2, 3, 4)
-println(array.contentDeepHashCode()) // 955331
+    println(array.contentDeepHashCode()) // 955331
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/collections/contentDeepToString|contentDeepToString()]]</code>‎:تعيد تمثيلًا نصيًا  استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
+*الدالة <code>[[Kotlin/collections/contentDeepHashCode|contentDeepHashCode()]]</code>‎: تعيد شيفرة hash لمحتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استدعيت معها كما لو كانت قائمة.
-*<code>[[Kotlin/collections/contentHashCode|contentHashCode()]]</code>‎:تعيد التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]].
+* التابع <nowiki/>[[Kotlin/Any/hashCode|<code>hashCode()</code>‎]]: يعيد شيفرة Hash للكائن الذي استُدعي معه.
+*الدالة <code>[[Kotlin/collections/contentToString|contentToString()]]</code>‎: تعيد سلسلة نصية تمثل محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة.
+* الدالة <code>[[Kotlin/collections/contentEquals|contentEquals()]]</code>‎: تتحقَّق إن كانت مصفوفتان متساويتين بنيويًا (''structurally'' equal).
 ==مصادر==
-*[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-hash-code.html صفحة الدالة contentHashCode()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]