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

من موسوعة حسوب
< Kotlin‏ | Any
لا ملخص تعديل
طلا ملخص تعديل
 
(7 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع Any.toString()في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎Any.toString()‎‎</code> في Kotlin}}</noinclude>
يعيد التابع <code>toString()‎</code> تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
تحول الدالة <code>toString()‎</code> الكائن الذي يُستدعى معه إلى سلسلة نصية (String).


== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
open fun toString(): String
open fun toString(): String
</syntaxhighlight>يُلاحظ وجود الكلمة المفتاحية <code>open</code> هنا وذلك للسماح بإعادة تعريف (override) هذا التابع في الأصناف الفرعيّة (subclasses) للصنف <code>[[Kotlin/Any|Any]]</code> (راجع صفحة [[Kotlin/classes|الأصناف والوراثة]]).
</syntaxhighlight>وجود الكلمة المفتاحيّة <code>open</code> هنا يدل على السماح بإعادة تعريف (override) هذه الدالة في الأصناف الفرعيّة (subclasses) للصنف <code>[[Kotlin/Any|Any]]</code> (راجع صفحة [[Kotlin/classes|الأصناف والوراثة]] للمزيد من التفاصيل).


== القيم المعادة ==
== القيم المعادة ==
سلسلة نصيّة (string) تمثّل الكائن المُحدَّد.
تعاد سلسلة نصيّة تضم جميع محتويات الكائن المعطى.


== أمثلة ==
== أمثلة ==
 
مثال على استعمال الدالة <code>toString()‎</code> مع سلسلة نصية:<syntaxhighlight lang="kotlin">
=== استخدام التابع <code>toString()‎</code> مع متغير بسيط ===
تُعرّف الشيفرة الآتية المتغيِّر <code>x</code> وتعطيه القيمة 5، وتطبع ناتج استدعاء التابع <code>toString()‎</code> على <code>x</code> والذي سيكون سلسلة نصيّة وليس قيمة عدديّة صحيحة:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
   val x = 5
   var x = 5
   println(x.toString()) // 5
   println(x.toString()) // 5
}
}
</syntaxhighlight>
</syntaxhighlight>مثالٌ آخر على استعمال الدالة <code>toString()‎</code> مع مصفوفة:<syntaxhighlight lang="kotlin">
 
=== استخدام التابع <code>toString()‎</code> مع المصفوفات ===
تنشئ الشيفرة الآتية مصفوفة من 5 عناصر ثم تطبع ناتج استدعاء التابع <code>toString()‎</code> على تلك المصفوفة:<syntaxhighlight lang="kotlin">
import java.util.*
import java.util.*


سطر 32: سطر 27:
== انظر أيضًا ==
== انظر أيضًا ==
* الصنف <code>[[Kotlin/Any|Any]]</code>: الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin.
* الصنف <code>[[Kotlin/Any|Any]]</code>: الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin.
* الدالة <code>[[Kotlin/collections/contentToString|contentToString()]]‎</code>: تعيد سلسلة نصية تمثِّل محتوى [[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت [[Kotlin/List|قائمة]].


== مصادر ==
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/to-string.html التابع toString في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin]
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/to-string.html صفحة الدالة ()toString في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Any]]

المراجعة الحالية بتاريخ 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(): تعيد سلسلة نصية تمثِّل محتوى المصفوفة التي استُدعيت معها كما لو كانت قائمة.

مصادر