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

المراجعة الحالية بتاريخ 12:33، 9 سبتمبر 2018

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

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

open fun toString(): String

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

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

أمثلة

استعمال الدالة toString()‎ لتحويل أحد ثوابت نسخة أنشئت من الصنف Enum إلى سلسلة نصية:

fun main(args: Array<String>) {
    val x = ColorEnum.Red

    print(x.toString()) // Red
}

enum class ColorEnum(val colorCode: Int)
{
    Red(2),
    Blue(11212),
    Green(21212),
    Orange(212121)
}

انظر أيضًا

الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّر إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان الكائن الأول (أي الذي استُدعي معها) أصغر من الكائن الثاني، أو قيمة موجبة إن كان الكائن الأول أكبر من الكائن الثاني.
الخاصيّة name: تمثل اسم الثابت المعرف في الكائن enum الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع Enum.toString()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE:الدالة <code>Enum.toString()‎</code> في Kotlin}}</noinclude>
-يطلق التابع <code>toString()</code>‎ استثناءً (exception) لأنّ ثوابت enum  لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع <code>[[Kotlin/Enum/index|Enum]]</code> من أن ترِث من الصنف <code>Cloneable</code>.
+تحول الدالة <code>toString()</code>‎ الكائن الذي استُدعي معها إلى [[Kotlin/String|سلسلة نصية]] (String).
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-protected fun clone(): Any
+open fun toString(): String
+</syntaxhighlight>
+== القيمة المعادة ==
+تعاد [[Kotlin/String|سلسلة نصية]] تضم جميع محتويات الكائن المعطى.
-</syntaxhighlight>
 == أمثلة ==
-في الشيفرة الآتية ننشئ صنفًا من النوع <code>Enum</code> باسم <code>ColorEnum</code> مكونًا من أربعة ثوابت  <code>Red</code>  و <code>Blue</code>  و <code>Green</code>  و <code>Orange</code>، ثم ننشئ متغيرًا <code>x</code> يحتوي القيمة <code>RED</code> للصنف <code>ColorEnum</code>، ثم نستدعي الدالة <code>toString()</code>‎عبر <code>x</code> ، وكنتيجة لذلك سيطلق المُصرّف استثناء:<syntaxhighlight lang="kotlin">
+استعمال الدالة <code>toString()</code>‎ لتحويل أحد ثوابت نسخة أنشئت من الصنف <code>[[Kotlin/Enum|Enum]]</code> إلى سلسلة نصية:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val x = ColorEnum.Red
-     val y = x.clone() // Error:(3, 14) Cannot access 'clone': it is protected in 'ColorEnum'
+     print(x.toString()) // Red
 }
 enum class ColorEnum(val colorCode: Int)
 {
-     Red(2),
+    Red(2),
-     Blue(11212),
+    Blue(11212),
-     Green(21212),
+    Green(21212),
-     Orange(212121)
+    Orange(212121)
- }
+}
 </syntaxhighlight>
 == انظر أيضًا ==
-* الخاصيّة <code>[[Kotlin/Enum/ordinal|ordinal]]</code>: تعيد ترتيب مُركّبة الكائن <code>enum</code> الذي استُدعيت عبره، أي ترتيبها في تصريح الكائن <code>enum،</code> بحيث تأخذ المُركّبة الأولى العدد <code>0</code>.
+* الدالة <code>[[Kotlin/Enum/compareTo|compareTo()‎]]</code> بين الكائن الذي استُدعي معها والكائن المُمرّر إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان الكائن الأول (أي الذي استُدعي معها) أصغر من الكائن الثاني، أو قيمة موجبة إن كان الكائن الأول أكبر من الكائن الثاني.
-* الخاصيّة <code>[[Kotlin/Enum/name|name]]</code>:تعيد اسم مُركّبة الكائن <code>enum</code> الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن.
+* الخاصيّة <code>[[Kotlin/Enum/name|name]]</code>: تمثل اسم الثابت المعرف في الكائن <code>enum</code> الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-enum/clone.html صفحة الدالة Enum.toString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-enum/to-string.html صفحة الدالة Enum.toString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Enum]]