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

من موسوعة حسوب
< Kotlin‏ | Any
اذهب إلى التنقل اذهب إلى البحث
ط
ط (مراجعة وتدقيق.)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: التابع <code>‎‎Any.toString()‎‎</code> في 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) تمثّل الكائن المُحدَّد.
+
تعاد سلسلة نصيّة تضم جميع محتويات الكائن المعطى.
  
 
== أمثلة ==
 
== أمثلة ==
سطر 35: سطر 35:
  
 
== مصادر ==
 
== مصادر ==
* [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 Method]]
 
[[تصنيف:Kotlin Method]]

مراجعة 10:56، 16 أغسطس 2018

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

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

open fun toString(): String

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

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

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

أمثلة

استخدام التابع toString()‎ مع متغير بسيط

تُعرّف الشيفرة الآتية المتغيِّر x وتسند إليه القيمة 5، ثم تطبع ناتج استدعاء التابع toString()‎ على المتغيّر x والذي سيكون سلسلةً نصيّةً وليس قيمةً عدديّة صحيحة:

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

استخدام التابع toString()‎ مع المصفوفات

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

مصادر