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

من موسوعة حسوب
لا ملخص تعديل
ط مراجعة وتدقيق.
سطر 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|لائحة]].   
تشفِّر الدالة <code>contentHashCode()‎</code> محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]] إلى شيفرة Hash.   


==البنية العامة==
==البنية العامة==
سطر 17: سطر 17:
</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|توثيق الدوال المباشرة]]).


== القيم المعادة ==
== القيم المعادة ==
 تعيد التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]].
 تعيد شيفرة Hash لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]].
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()contentHashCode</code> مع المصفوفات ===
===استخدام الدالة <code>()contentHashCode</code> مع المصفوفات ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من أربعة أعداد  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentHashCode</code> للحصول على تكويد [[Kotlin/Array|المصفوفة]] ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()contentHashCode</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(1,2,3,4)
سطر 33: سطر 33:
</syntaxhighlight>
</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/contentDeepHashCode|contentDeepHashCode()]]</code>‎:تعيد التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]]<nowiki/>المُتشعبة تعامل كاللوائح هي كذلك.  
*الدالة <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-hash-code.html الدالة  contentHashCode()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-hash-code.html الدالة contentHashCode()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 07:53، 4 يوليو 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 لمحتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.

أمثلة

استخدام الدالة ()contentHashCode مع المصفوفات

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

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

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

انظر أيضًا

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

مصادر