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

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

تحول الدالة toString()‎ الكائن الذي يُستدعى معه إلى سلسلة نصية (String).

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

open fun toString(): String

وجود الكلمة المفتاحيّة open هنا يدل على السماح بإعادة تعريف (override) هذه الدالة في الأصناف الفرعيّة (subclasses) للصنف Any (راجع صفحة الأصناف والوراثة للمزيد من التفاصيل).

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

تعاد سلسلة نصيّة تضم جميع محتويات الكائن المعطى.

أمثلة

مثال على استعمال الدالة toString()‎ مع سلسلة نصية:

fun main(args: Array<String>) {
   var x = 5
   println(x.toString()) // 5
}

مثالٌ آخر على استعمال الدالة toString()‎ مع مصفوفة:

import java.util.*

fun main(args: Array<String>) {
   val nums = arrayOf(1, 2, 3, 4, 5)
   println(Arrays.toString(nums))  // [1, 2, 3, 4, 5]
}

انظر أيضًا

الصنف Any: الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin.
الدالة contentToString()‎: تعيد سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.

مصادر

صفحة الدالة ()toString في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع Any.toString()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎Any.toString()‎‎</code> في Kotlin}}</noinclude>
-يعيد التابع toString()‎ تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
+تحول الدالة <code>toString()‎</code> الكائن الذي يُستدعى معه إلى سلسلة نصية (String).
 == البنية العامة ==
+<syntaxhighlight lang="kotlin">
 open fun toString(): String
+</syntaxhighlight>وجود الكلمة المفتاحيّة <code>open</code> هنا يدل على السماح بإعادة تعريف (override) هذه الدالة في الأصناف الفرعيّة (subclasses) للصنف <code>[[Kotlin/Any|Any]]</code> (راجع صفحة [[Kotlin/classes|الأصناف والوراثة]] للمزيد من التفاصيل).
-يُلاحظ وجود الكلمة المفتاحية open هنا وذلك للسماح بإعادة تعريف (override) هذا التابع في الأصناف الفرعيّة (subclasses) للصنف Any (راجع صفحة [[Kotlin/classes|الأصناف والوراثة]]).
 == القيم المعادة ==
-سلسلة نصيّة (string) تمثّل الكائن المُحدَّد.
+تعاد سلسلة نصيّة تضم جميع محتويات الكائن المعطى.
 == أمثلة ==
+مثال على استعمال الدالة <code>toString()‎</code> مع سلسلة نصية:<syntaxhighlight lang="kotlin">
-=== استخدام التابع toString()‎ مع متغير بسيط ===
-تُعرّف الشيفرة الآتية المتغيِّر x وتعطيه القيمة 5، وتطبع ناتج استدعاء التابع toString()‎ على x والذي سيكون سلسلة نصيّة وليس قيمة عدديّة صحيحة:
 fun main(args: Array<String>) {
+   var x = 5
-   val x = 5
    println(x.toString()) // 5
 }
+</syntaxhighlight>مثالٌ آخر على استعمال الدالة <code>toString()‎</code> مع مصفوفة:<syntaxhighlight lang="kotlin">
-=== استخدام التابع toString()‎ مع المصفوفات ===
-تنشئ الشيفرة الآتية مصفوفة من 5 عناصر ثم تطبع ناتج استدعاء التابع toString()‎ على تلك المصفوفة:
 import java.util.*
 fun main(args: Array<String>) {
    val nums = arrayOf(1, 2, 3, 4, 5)
    println(Arrays.toString(nums))  // [1, 2, 3, 4, 5]
 }
+</syntaxhighlight>
 == انظر أيضًا ==
-* الصنف String: الصنف الذي يمثل السلاسل النصية.
+* الصنف <code>[[Kotlin/Any|Any]]</code>: الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin.
-* الصنف Any: الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin.
+* الدالة <code>[[Kotlin/collections/contentToString|contentToString()]]‎</code>: تعيد سلسلة نصية تمثِّل محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]].
 == مصادر ==
-* التابع toString في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/to-string.html صفحة الدالة ()toString في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Any]]