الدالة toString()‎ في Kotlin

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

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

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)).

المعاملات

radix

عدد صحيح بين 2 و 36 الذي يُمثِّل الأساس المستعمل في تحويل القيمة العددية إلى سلسلة نصية؛ لاستخدام نظام العد العشري (decimal) شائع الاستخدام بين البشر، فحدِّد القيمة 10.

إن كانت القيمة المعطاة لهذا المعامل غير صالحة، فسيُطلَق الاستثناء IllegalArgumentException.

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

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

أمثلة

مثالٌ على استعمال الدالة toString()‎:

fun main(args: Array<String>) {
    println((-50).toString(16)) // -32
    println(5.toString())       // 5
    println(5757.toString()     // 5757
}

انظر أيضًا

• الدالة toBoolean()‎: تعيد القيمة true إن كانت السلسلة النصية التي استٌدعيت معها تساوي "true" مع تجاهل حالة الأحرف، أو تعيد القيمة false.
• الدالة toByteArray()‎: ترمز جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray.
• الدالة toCollection()‎: تضيف كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
• الدالة toHashSet()‎: تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
• الدالة toList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر.
• الدالة toLong()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل.
• الدالة toLowerCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
• الدالة toMutableList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.
• الدالة toSet()‎: تضيف كل محارف سلسلة الحروف  التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.
• الدالة toShort()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير.
• الدالة toUpperCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).
• الدالة isLetterOrDigit()‎: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا أو رقمًا.

مصادر

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