Kotlin/Any/toString

يعيد التابع toString()‎ تمثيلًا نصيًا للكائن الذي يُستدعى عبره.

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

open fun toString(): String

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

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

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

أمثلة

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

مصادر

• صفحة التابع toString في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.