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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>contentToString()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>contentDeepToString()‎</code>تم...'
 
طلا ملخص تعديل
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>contentToString()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>contentToString()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>contentDeepToString()‎</code>تمثيلًا نصيًا لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك. 
تعيد الدالة <code>contentToString()‎</code> سلسلة نصية تمثِّل محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]].   
 
ان احتوت [[Kotlin/Array|المصفوفة]] نفسها في أي مستوى من المستويات المتشعبة فإن ذلك المرجع (reference) سيعاد على الشكل <code>"[...]"</code> لمنع العَودية (recursion).   


==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.contentDeepToString(): String
inline fun <T> Array<out T>.contentToString(): String
inline fun ByteArray.contentToString(): String
inline fun ShortArray.contentToString(): String
inline fun IntArray.contentToString(): String
inline fun LongArray.contentToString(): String
inline fun FloatArray.contentToString(): String
inline fun DoubleArray.contentToString(): String
inline fun BooleanArray.contentToString(): String
inline fun CharArray.contentToString(): String  


</syntaxhighlight>
</syntaxhighlight>


<u>'''الإصدار المطلوب: Kotlin 1.1'''</u>
'''الإصدار المطلوب:''' Kotlin 1.1


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


== القيم المعادة ==
== القيم المعادة ==
تمثيل نصي ([[Kotlin/String|String]]) لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
تُعاد [[Kotlin/String|سلسلة نصية]] تمثِّل محتوى [[Kotlin/Array|المصفوفة]] المعطاة كما لو كانت [[Kotlin/List|قائمة]].
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()contentDeepToString</code> مع المصفوفات المتشعبة ===
تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()contentToString</code> للحصول على سلسلة نصية تمثل هذه المصفوفة:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية [[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(
    val array = arrayOf("تفاح." + "برتقال." + "ليمون.")
    intArrayOf(3, 7, 9),
 
    intArrayOf(0, 1, 0),
     println(array.contentToString()) // [تفاح.برتقال.ليمون.]
     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|لائحة]].  
* الدالة [[Kotlin/collections/contentDeepToString|<code>contentDeepToString()</code>‎]]: تعيد سلسلة نصية تمثِّل محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة.
*<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 لمحتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة.
*الدالة <code>[[Kotlin/collections/contentEquals|contentEquals()]]</code>‎: تتحقَّق إن كانت مصفوفتان متساويتين بنيويًا (''structurally'' equal).  


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

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

تعيد الدالة contentToString()‎ سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.

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

inline fun <T> Array<out T>.contentToString(): String 
inline fun ByteArray.contentToString(): String 
inline fun ShortArray.contentToString(): String
inline fun IntArray.contentToString(): String
inline fun LongArray.contentToString(): String 
inline fun FloatArray.contentToString(): String 
inline fun DoubleArray.contentToString(): String 
inline fun BooleanArray.contentToString(): String 
inline fun CharArray.contentToString(): String

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

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

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

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

أمثلة

تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()contentToString للحصول على سلسلة نصية تمثل هذه المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf("تفاح." + "برتقال." + "ليمون.")

    println(array.contentToString()) // [تفاح.برتقال.ليمون.]
}

انظر أيضًا

  • الدالة contentHashCode()‎: تعيد شيفرة Hash لمحتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.
  • الدالة contentEquals()‎: تتحقَّق إن كانت مصفوفتان متساويتين بنيويًا (structurally equal).

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/collections/contentToString&oldid=17085»