الفرق بين المراجعتين ل"Kotlin/collections/contentDeepToString"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepToString()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>contentDeepToString()‎</code...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepToString()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepToString()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة <code>contentDeepToString()‎</code>التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.   
+
تعيد الدالة<code>contentDeepToString()‎</code>تمثيلًا نصيًا لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.   
  
ان احتوت [[Kotlin/Array|المصفوفة]] نفسها في أي مستوى من المستويات المتشعبة فإن سلوك الدالة سيكون غير محدد.   
+
ان احتوت [[Kotlin/Array|المصفوفة]] نفسها في أي مستوى من المستويات المتشعبة فإن ذلك المرجع (reference) سيعاد على الشكل <code>"[...]"</code> لمنع العَودية (recursion).   
  
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.contentDeepToString(): Int
+
inline fun <T> Array<out T>.contentDeepToString(): String
  
 
</syntaxhighlight>
 
</syntaxhighlight>
سطر 15: سطر 15:
  
 
== القيم المعادة ==
 
== القيم المعادة ==
 تعيد التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
+
تمثيل نصي ([[Kotlin/String|String]]) لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()contentDeepToString</code> مع المصفوفات ===
+
===استخدام الدالة <code>()contentDeepToString</code> مع المصفوفات المتشعبة ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من أربعة أعداد  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentDeepToString</code> للحصول على تكويد [[Kotlin/Array|المصفوفة]] ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ثلاث مصفوفات عددية  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentDeepToString</code> للحصول على تمثيل نصي [[Kotlin/Array|للمصفوفة]] ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4)
+
val array = arrayOf(
 
+
    intArrayOf(3, 7, 9),
println(array.contentDeepHashCode()) // 955331
+
    intArrayOf(0, 1, 0),
 +
    intArrayOf(2, 4, 8)
 +
)
 +
println(array.contentDeepToString()) // [[3, 7, 9], [0, 1, 0], [2, 4, 8]]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
 +
*<code>[[Kotlin/collections/contentToString|contentToString()]]</code>‎: تعيد تمثيلًا نصيًا لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]].
 
*<code>[[Kotlin/collections/contentDeepToString|contentDeepToString()]]</code>‎:تعيد تمثيلًا نصيًا  استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.  
 
*<code>[[Kotlin/collections/contentDeepToString|contentDeepToString()]]</code>‎:تعيد تمثيلًا نصيًا  استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.  
 
*<code>[[Kotlin/collections/contentHashCode|contentHashCode()]]</code>‎:تعيد التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]].  
 
*<code>[[Kotlin/collections/contentHashCode|contentHashCode()]]</code>‎:تعيد التكويد (hash code) استنادًا إلى محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]].  
  
 
==مصادر==
 
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-deep-hash-code.html الدالة  contentDeepToString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-deep-to-string.html الدالة  contentDeepToString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 20:44، 12 مايو 2018

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

ان احتوت المصفوفة نفسها في أي مستوى من المستويات المتشعبة فإن ذلك المرجع (reference) سيعاد على الشكل "[...]" لمنع العَودية (recursion).

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

inline fun <T> Array<out T>.contentDeepToString(): String

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

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

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

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

أمثلة

استخدام الدالة ()contentDeepToString مع المصفوفات المتشعبة

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

fun main(args: Array<String>) {
val array = arrayOf(
    intArrayOf(3, 7, 9),
    intArrayOf(0, 1, 0),
    intArrayOf(2, 4, 8)
)
println(array.contentDeepToString()) // [[3, 7, 9], [0, 1, 0], [2, 4, 8]]
}

انظر أيضًا

مصادر