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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepHashCode()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>contentDeepHashCode()‎</code...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepHashCode()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepHashCode()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة <code>contentDeepHashCode()‎</code> االقيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك.   
تعيد الدالة <code>contentDeepHashCode()‎</code>التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك. 
 
ان احتوت المصفوفة نفسها في أي مستوى من المستويات المتشعبة فإن سلوك الدالة سيكون غير محدد. 
 
المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك.   


==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline infix fun <T> Array<out T>.contentEquals(
inline fun <T> Array<out T>.contentDeepHashCode(): Int
    other: Array<out T>
 
): Boolean
inline infix fun ByteArray.contentEquals(
    other: ByteArray
): Boolean
inline infix fun ShortArray.contentEquals(
    other: ShortArray
): Boolean
inline infix fun IntArray.contentEquals(
    other: IntArray
): Boolean
inline infix fun LongArray.contentEquals(
    other: LongArray
): Boolean
inline infix fun FloatArray.contentEquals(
    other: FloatArray
): Boolean
inline infix fun DoubleArray.contentEquals(
    other: DoubleArray
): Boolean
inline infix fun BooleanArray.contentEquals(
    other: BooleanArray
): Boolean
inline infix fun CharArray.contentEquals(
    other: CharArray
): Boolean
</syntaxhighlight>
</syntaxhighlight>


سطر 37: سطر 16:
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].


ويُلاحَظ كذلك وجود الكلمة المفتاحية <code>infix</code> للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخلي (Infix notation)، أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/functions#.D8.A7.D9.84.D8.AA.D8.AF.D9.88.D9.8A.D9.86 .D8.A7.D9.84.D8.AF.D8.A7.D8.AE.D9.84.D9.8A.D9.91 .28Infix notation.29|توثيق التدوين الداخلي (infix functions)]].
 
==القيم المعادة==
==القيم المعادة==
 <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك.  
 تعيد التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()contentEquals</code> مع مصفوفتين متساويتين ===
===استخدام الدالة <code>()contentDeepHashCode</code> مع مصفوفتين متساويتين ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفتين]] لهما نفس عدد العناصر ونفس العناصر بنفس الترتيب باسم <code>array</code> و <code>array2</code>مكونتان من أربعة أعداد  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentEquals</code> للتحقق من أنّ الحرفين المصفوفتين متساويتين بعمق ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من أربعة أعداد  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentDeepHashCode</code> للحصلو على تكويد [[Kotlin/Array|المصفوفة]] ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4)
val array2 = arrayOf(1,2,3,4)
 
println(array.contentEquals(array2)) // true
}
</syntaxhighlight>
===استخدام الدالة <code>()contentDeepHashCode</code> مع مصفوفتين غير متساويتين ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفتين]] لهما نفس عدد العناصر ولكن تختلفان في أحد العناصر ب باسم <code>array</code> و <code>array2</code> مكونة من أربعة أعداد  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentEquals</code> للتحقق من أنّ الحرفين المصفوفتين متساويتين بعمق ثم تطبع الناتج:<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)
val array2 = arrayOf(1,2,3,6)


println(array.contentEquals(array2)) // false
println(array.contentDeepHashCode()) // 955331
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
==انظر أيضًا==
*<code>[[Kotlin/collections/contentDeepEquals|contentDeepEquals()]]</code>‎: تعيد القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر  ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك.  وتعمل على المستويات المتشعبة كذلك.  
*<code>[[Kotlin/collections/contentDeepEquals|contentDeepToString()]]</code>‎: تعيد القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفتان]] المحددتان متساويتان بنيويًا (''structurally'' equal)، أي أنهما تحتويان على نفس عدد العناصر  ونفس العناصر بنفس الترتيب، وتعيد <code>false</code> خلاف ذلك.  وتعمل على المستويات المتشعبة كذلك.  


==مصادر==
==مصادر==

مراجعة 19:06، 12 مايو 2018

تعيد الدالة contentDeepHashCode()‎التكويد (hash code) استنادًا إلى محتوى المصفوفة التي استُدعيت عبرها كما لو كانت لائحة، المصفوفات المُتشعبة تعامل كاللوائح هي كذلك.

ان احتوت المصفوفة نفسها في أي مستوى من المستويات المتشعبة فإن سلوك الدالة سيكون غير محدد.

المحددتان متساويتان بنيويًا (structurally equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد false خلاف ذلك.

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

inline fun <T> Array<out T>.contentDeepHashCode(): Int

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

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


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

 تعيد التكويد (hash code) استنادًا إلى محتوى المصفوفة التي استُدعيت عبرها كما لو كانت لائحة، المصفوفات المُتشعبة تعامل كاللوائح هي كذلك.

أمثلة

استخدام الدالة ()contentDeepHashCode مع مصفوفتين متساويتين

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من أربعة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()contentDeepHashCode للحصلو على تكويد المصفوفة ثم تطبع الناتج:

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

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

انظر أيضًا

  • contentDeepToString()‎: تعيد القيمة true إن كانت المصفوفتان المحددتان متساويتان بنيويًا (structurally equal)، أي أنهما تحتويان على نفس عدد العناصر ونفس العناصر بنفس الترتيب، وتعيد false خلاف ذلك. وتعمل على المستويات المتشعبة كذلك.

مصادر