التابع text.toString()‎ في لغة Kotlin

تعيد الدالة toString()‎ تمثيلا نصيًا للعدد الذي استٌدعيت عبره وفق الأساس المُحدّد radix.

إن كانت قيمة radix غير صالحة في عملية التحويل من عدد إلى سلسلة نصية فستطلق الدالةُ استثناءً IllegalArgumentException .

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

inline actual fun Byte.toString(radix: Int): String
inline actual fun Short.toString(radix: Int): String 
inline actual fun Int.toString(radix: Int): String
inline actual fun Long.toString(radix: Int): String

بيئة التشغيل المطلوبة: Kotlin 1.1

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

سلسلة نصية.

أمثلة

استخدام الدالة toString()‎ مع السلاسل النصية

تستدعي الشيفرة الآتية الدالة toString()‎ عبر عدة سلاسل نصية، وتطبع الناتج:

fun main(args: Array<String>) {
    println((-50).toString(16)) // -32
    println(5.toString()) // 5
    println(5757.toString()) // [H, b, o, s, u]
}

انظر أيضًا

• toList()‎ : تعيد الدالة toList()‎ لائحة تحتوي كل حروف سلسلة الحروف  التي استٌدعيت عبرها.

• toDouble()‎ : تحلّل الدالة toDouble()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Double وتعيد الناتج.

• toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).

• toBigDecimalOrNull()‎: تحلّل الدالة toBigDecimalOrNull()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.
• toBigDecimal()‎: تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.

• isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

• صفحة الدالة text.toString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.