الفرق بين المراجعتين لصفحة: «Kotlin/Any/hashCode»
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>Any.hashCode()</code> في Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>Any.hashCode()</code> في Kotlin}}</noinclude> | ||
تعيد الدالة <code>hashCode()</code> الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. تُحقِّق هذه الدالة الشرطين الآتيين دائمًا: | |||
* | *تعيد نفس العدد الصحيح دائمًا في كل مرة تستدعى فيها مع الكائن نفسه شريطة عدم تغيُّر أيّ معلومة تستخدمها الدالة [[Kotlin/Any/equals|<code>equals()</code>]] عند موازنة هذا الكائن مع غيره. | ||
*إذا تساوى كائنان بحسب | *إذا تساوى كائنان بحسب الدالة <code>[[Kotlin/Any/equals|equals()]]</code>، فيجب أن تعيد الدالة <code>hashCode()</code> شيفرة hash نفسها لكلٍّ منها. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
open fun hashCode(): Int | open fun hashCode(): Int | ||
</syntaxhighlight> | </syntaxhighlight>وجود الكلمة المفتاحيّة <code>open</code> هنا يدل على السماح بإعادة تعريف (override) هذا التابع في الأصناف الفرعيّة (subclasses) للصنف <code>[[Kotlin/Enum|Enum]]</code> (راجع [[Kotlin/classes|الأصناف والوراثة]] لمزيد من التفاصيل). | ||
==القيم المعادة== | ==القيم المعادة== | ||
قيمةٌ صحيحةٌ | تعاد قيمةٌ [[Kotlin/Int|عددية صحيحةٌ]] تمثِّل الشيفرة hash للكائن المعطى. | ||
==أمثلة== | ==أمثلة== | ||
تعرِّف الشيفرة الآتية متغيِّرًا من نوع السلاسل النصيّة (String) ثم تستدعي التابع <code>hashCode()</code> للحصول على الشيفرة hash الخاصّة بتلك السلسة النصيّة وطباعتها، ثم تُعرّف متغيّرًا <code>x</code> وتستدعي التابع كذلك للحصول على الشيفرة hash له وطباعتها، كما يلي:<syntaxhighlight lang="kotlin"> | |||
تعرِّف الشيفرة الآتية متغيِّرًا من نوع السلاسل النصيّة ( | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
var a: String = "hsoub" | var a: String = "hsoub" | ||
| سطر 24: | سطر 23: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
*التابع [[Kotlin/Any/equals| | *التابع <code>[[Kotlin/Any/equals|equals()]]</code>: يتحقق فيما إذا كان هناك كائنٌ (object) آخر مساوٍ للكائن الحاليّ. | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/hash-code.html صفحة التابع Any.hashCode() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/hash-code.html صفحة التابع Any.hashCode() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] | ||
مراجعة 10:47، 16 أغسطس 2018
تعيد الدالة hashCode() الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. تُحقِّق هذه الدالة الشرطين الآتيين دائمًا:
- تعيد نفس العدد الصحيح دائمًا في كل مرة تستدعى فيها مع الكائن نفسه شريطة عدم تغيُّر أيّ معلومة تستخدمها الدالة
equals() عند موازنة هذا الكائن مع غيره. - إذا تساوى كائنان بحسب الدالة
equals()، فيجب أن تعيد الدالةhashCode() شيفرة hash نفسها لكلٍّ منها.
البنية العامة
open fun hashCode(): Int
وجود الكلمة المفتاحيّة open هنا يدل على السماح بإعادة تعريف (override) هذا التابع في الأصناف الفرعيّة (subclasses) للصنف Enum (راجع الأصناف والوراثة لمزيد من التفاصيل).
القيم المعادة
تعاد قيمةٌ عددية صحيحةٌ تمثِّل الشيفرة hash للكائن المعطى.
أمثلة
تعرِّف الشيفرة الآتية متغيِّرًا من نوع السلاسل النصيّة (String) ثم تستدعي التابع hashCode() للحصول على الشيفرة hash الخاصّة بتلك السلسة النصيّة وطباعتها، ثم تُعرّف متغيّرًا x وتستدعي التابع كذلك للحصول على الشيفرة hash له وطباعتها، كما يلي:
fun main(args: Array<String>) {
var a: String = "hsoub"
var hash_a = a.hashCode()
println(" $hash_a") // 99582545
var x = 54
var hash_x = x.hashCode()
println(" $hash_x") //54
}
انظر أيضًا
- التابع
equals(): يتحقق فيما إذا كان هناك كائنٌ (object) آخر مساوٍ للكائن الحاليّ.