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