الفرق بين المراجعتين ل"Kotlin/Enum/toString"

من موسوعة حسوب
< Kotlin‏ | Enum
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع Enum.toString()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:الدالة <code>Enum.toString()‎</code> في Kotlin}}</noinclude>
يعيد التابع <code>toString()</code>‎ تمثيلا نصيا للكائن الذي استُدعيت عبره.  
+
تحول الدالة <code>toString()</code>‎ الكائن الذي استُدعي معها إلى [[Kotlin/String|سلسلة نصية]] (String).  
  
 
== البنية العامة ==
 
== البنية العامة ==
سطر 7: سطر 7:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
== القيمة المُعادة ==
+
== القيمة المعادة ==
[[Kotlin/String|سلسلة نصية]].
+
تعاد [[Kotlin/String|سلسلة نصية]] تضم جميع محتويات الكائن المعطى.
  
 
== أمثلة ==
 
== أمثلة ==
في الشيفرة الآتية ننشئ صنفًا من النوع <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>) {
 
fun main(args: Array<String>) {
 
     val x = ColorEnum.Red
 
     val x = ColorEnum.Red
سطر 29: سطر 29:
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* الخاصيّة <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> الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن.
  
 
== مصادر ==
 
== مصادر ==

مراجعة 11:24، 16 أغسطس 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 الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن.

مصادر