الدالة contentDeepToString()‎ في لغة Kotlin

تعيد الدالة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]]
}

انظر أيضًا

• contentToString()‎: تعيد تمثيلًا نصيًا لمحتوى المصفوفة التي استُدعيت عبرها كما لو كانت لائحة.
• contentHashCode()‎:تعيد التكويد (hash code) استنادًا إلى محتوى المصفوفة التي استُدعيت عبرها كما لو كانت لائحة.

مصادر

• الدالة  contentDeepToString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.