الفرق بين المراجعتين ل"Kotlin/collections/contentDeepToString"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
|||
| سطر 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|المصفوفة]] نفسها في أي مستوى من المستويات المتشعبة، فسيعاد ذلك المرجع (reference) بالشكل <code>"[...]"</code> لمنع العَودية (recursion). | |
==البنية العامة== | ==البنية العامة== | ||
| سطر 10: | سطر 10: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | '''الإصدار المطلوب: Kotlin 1.1''' | |
| − | + | وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]). | |
== القيم المعادة == | == القيم المعادة == | ||
| − | + | [[Kotlin/String|سلسلة نصية]] تمثل محتوى [[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> للحصول على سلسلة نصية تمثل تلك المصفوفة:<syntaxhighlight lang="kotlin"> |
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf( | val array = arrayOf( | ||
| سطر 29: | سطر 29: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| − | *<code>[[Kotlin/collections/contentToString|contentToString()]]</code>: تعيد | + | *الدالة <code>[[Kotlin/collections/contentToString|contentToString()]]</code>: تعيد سلسلة نصية تمثل محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]]. |
| − | *<code>[[Kotlin/collections/contentHashCode|contentHashCode()]]</code>:تعيد | + | *الدالة <code>[[Kotlin/collections/contentHashCode|contentHashCode()]]</code>: تعيد شيفرة hash لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]]. |
| + | *الدالة <code>[[Kotlin/collections/contentDeepEquals|contentDeepEquals()]]</code>: تتحقَّق من تساوي مصفوفتين بالعُمق، أي أنَّهما تحتويان على نفس العناصر وبنفس الترتيب. | ||
| + | *الدالة <code>[[Kotlin/collections/contentEquals|contentEquals()]]</code>: تتحقَّق إن كانت مصفوفتان متساويتان بنيويًا (''structurally'' equal). | ||
==مصادر== | ==مصادر== | ||
| − | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-deep-to-string.html الدالة | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/content-deep-to-string.html الدالة contentDeepToString() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 07:17، 4 يوليو 2018
تعيد الدالة contentDeepToString() سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة. تعامل المصفوفات المُتشعبة مثل معاملة القوائم أيضًا.
إن حَوَت المصفوفة نفسها في أي مستوى من المستويات المتشعبة، فسيعاد ذلك المرجع (reference) بالشكل "[...]" لمنع العَودية (recursion).
البنية العامة
inline fun <T> Array<out T>.contentDeepToString(): String
الإصدار المطلوب: Kotlin 1.1
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة).
القيم المعادة
سلسلة نصية تمثل محتوى المصفوفة كما لو كانت قائمة.
أمثلة
استخدام الدالة ()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 لمحتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة. - الدالة
contentDeepEquals(): تتحقَّق من تساوي مصفوفتين بالعُمق، أي أنَّهما تحتويان على نفس العناصر وبنفس الترتيب. - الدالة
contentEquals(): تتحقَّق إن كانت مصفوفتان متساويتان بنيويًا (structurally equal).