عرض مصدر Kotlin/collections/contentDeepToString

<noinclude>{{DISPLAYTITLE: الدالة <code>contentDeepToString()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>contentDeepToString()‎</code> سلسلة نصية تمثِّل محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]]. تعامل [[Kotlin/Array|المصفوفات]] المُتشعبة مثل معاملة [[Kotlin/List|القوائم]] أيضًا.  

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

==البنية العامة==
<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.contentDeepToString(): String

</syntaxhighlight>

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

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

== القيم المعادة ==
تُعاد [[Kotlin/String|سلسلة نصية]] تمثل محتوى [[Kotlin/Array|المصفوفة]] كما لو كانت [[Kotlin/List|قائمة]].
==أمثلة==
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()contentDeepToString</code> للحصول على سلسلة نصية تمثل تلك المصفوفة:<syntaxhighlight lang="kotlin">
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]]
}
</syntaxhighlight>
==انظر أيضًا==
*الدالة <code>[[Kotlin/collections/contentToString|contentToString()]]</code>‎: تعيد سلسلة نصية تمثل محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]]. 
* الدالة <code>[[Kotlin/collections/contentDeepHashCode|contentDeepHashCode()]]</code>‎: تعيد شيفرة hash لمحتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استدعيت معها كما لو كانت قائمة.
*الدالة <code>[[Kotlin/collections/contentDeepEquals|contentDeepEquals()‎]]</code>: تتحقَّق من تساوي مصفوفتين بالعُمق، أي أنَّهما تحتويان على نفس العناصر وبنفس الترتيب. 

==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-deep-to-string.html صفحة الدالة contentDeepToString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]