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

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


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


</syntaxhighlight>
== القيم المعادة ==
== القيم المعادة ==
سلسلة نصيّة (string) تمثّل الكائن المُحدَّد.
تعاد [[Kotlin/String|سلسلة نصيّة]] (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>) {
   var 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>arrayOf</code> ثم تطبع ناتج استدعاء التابع <code>toString()‎</code> على تلك المصفوفة:<syntaxhighlight lang="kotlin">
import java.util.*
import java.util.*


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


== انظر أيضًا ==
== انظر أيضًا ==
* الصنف <code>[[Kotlin/Any|Any]]</code>: الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin.
* الدالة <nowiki/>[[Kotlin/Any/hashCode|<code>hashCode()</code>‎]]: يعيد قيمة الشيفرة hash الخاصّة بالكائن الذي استُدعي معه.


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

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

تعيد الدالة toString()‎ سلسلة نصية تمثل الكائن الذي استدعيت معه.

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

fun Any?.toString(): String

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

تعاد سلسلة نصيّة (string) تمثّل الكائن المُحدَّد.

أمثلة

استخدام الدالة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]
}

انظر أيضًا

  • الدالة hashCode(): يعيد قيمة الشيفرة hash الخاصّة بالكائن الذي استُدعي معه.

مصادر