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

مراجعة 20:49، 12 مايو 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 للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

تمثيل نصي (String) لمحتوى المصفوفة التي استُدعيت عبرها كما لو كانت لائحة.

أمثلة

استخدام الدالة `()contentToString` مع المصفوفات

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ثلاث سلاسل نصية باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()contentToString للحصول على تمثيل نصي للمصفوفة ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf("apples", "oranges", "lime")

println(array.contentToString()) // [apples, oranges, lime]
}

انظر أيضًا

[null contentDeepToString()]‎:تعيد تمثيلًا نصيًا استنادًا إلى محتوى المصفوفة التي استُدعيت عبرها كما لو كانت لائحة، المصفوفات المُتشعبة تعامل كاللوائح هي كذلك.

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <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">
-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>
@@ سطر 15: / سطر 21: @@
 == القيم المعادة ==
-تمثيل نصي ([[Kotlin/String|String]]) لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]]، [[Kotlin/Array|المصفوفات]] المُتشعبة تعامل [[Kotlin/List|كاللوائح]] هي كذلك.
+تمثيل نصي ([[Kotlin/String|String]]) لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]].
 ==أمثلة==
-===استخدام الدالة <code>()contentDeepToString</code> مع المصفوفات المتشعبة ===
+===استخدام الدالة <code>()contentToString</code> مع المصفوفات  ===
-تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ثلاث مصفوفات عددية  باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentDeepToString</code> للحصول على تمثيل نصي [[Kotlin/Array|للمصفوفة]] ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ثلاث سلاسل نصية باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()contentToString</code> للحصول على تمثيل نصي [[Kotlin/Array|للمصفوفة]] ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(
+val array = arrayOf("apples", "oranges", "lime")
-    intArrayOf(3, 7, 9),
-    intArrayOf(0, 1, 0),
+println(array.contentToString()) // [apples, oranges, lime]
-    intArrayOf(2, 4, 8)
-)
-println(array.contentDeepToString()) // [[3, 7, 9], [0, 1, 0], [2, 4, 8]]
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/collections/contentToString|contentToString()]]</code>‎: تعيد تمثيلًا نصيًا لمحتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت [[Kotlin/List|لائحة]].
+* <code>[null contentDeepToString()]</code>‎:تعيد تمثيلًا نصيًا استنادًا إلى محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها كما لو كانت لائحة، <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|لائحة]].
 ==مصادر==
-*[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 Functions]]