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

من موسوعة حسوب
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function'
طلا ملخص تعديل
 
سطر 17: سطر 17:
تُعاد [[Kotlin/String|سلسلة نصية]] تمثل محتوى [[Kotlin/Array|المصفوفة]] كما لو كانت [[Kotlin/List|قائمة]].
تُعاد [[Kotlin/String|سلسلة نصية]] تمثل محتوى [[Kotlin/Array|المصفوفة]] كما لو كانت [[Kotlin/List|قائمة]].
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()contentDeepToString</code> مع المصفوفات المتشعبة ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()contentDeepToString</code> للحصول على سلسلة نصية تمثل تلك المصفوفة:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()contentDeepToString</code> للحصول على سلسلة نصية تمثل تلك المصفوفة:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
سطر 37: سطر 36:
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 07:26، 8 سبتمبر 2018

تعيد الدالة contentDeepToString()‎ سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة. تعامل المصفوفات المُتشعبة مثل معاملة القوائم أيضًا.

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

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

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

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

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

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

تُعاد سلسلة نصية تمثل محتوى المصفوفة كما لو كانت قائمة.

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم 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]]
}

انظر أيضًا

  • الدالة contentToString()‎: تعيد سلسلة نصية تمثل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.
  • الدالة contentDeepHashCode()‎: تعيد شيفرة hash لمحتوى المصفوفة التي استدعيت معها كما لو كانت قائمة.
  • الدالة contentDeepEquals()‎: تتحقَّق من تساوي مصفوفتين بالعُمق، أي أنَّهما تحتويان على نفس العناصر وبنفس الترتيب.

مصادر