الفرق بين المراجعتين لصفحة: «Kotlin/collections/contentDeepToString»
< Kotlin | collections
أنشأ الصفحة ب'<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> | تعيد الدالة<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(): | inline fun <T> Array<out T>.contentDeepToString(): String | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 15: | سطر 15: | ||
== القيم المعادة == | == القيم المعادة == | ||
تمثيل نصي ([[Kotlin/String|String]]) لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك. | |||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()contentDeepToString</code> مع المصفوفات === | ===استخدام الدالة <code>()contentDeepToString</code> مع المصفوفات المتشعبة === | ||
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من | تعرف الشيفرة الآتية [[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, | val array = arrayOf( | ||
intArrayOf(3, 7, 9), | |||
println(array. | 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- | *[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]]
}
انظر أيضًا
contentToString(): تعيد تمثيلًا نصيًا لمحتوى المصفوفة التي استُدعيت عبرها كما لو كانت لائحة.contentDeepToString():تعيد تمثيلًا نصيًا استنادًا إلى محتوى المصفوفة التي استُدعيت عبرها كما لو كانت لائحة، المصفوفات المُتشعبة تعامل كاللوائح هي كذلك.contentHashCode():تعيد التكويد (hash code) استنادًا إلى محتوى المصفوفة التي استُدعيت عبرها كما لو كانت لائحة.